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David Herron 

软件 开发 人 员 和 软件 质量 工程 师 ， 在 硅谷 从 业 20 
多 年 ， 目 前 在 雅虎 担任 质量 工程 小 组 的 架构 师 ， 管 控 
公司 基于 Node 开 发 的 Web 应 用 平台 的 质量 。 

他 曾 为 Sun 公 司 主管 工程 师 ， 并 作为 Java SE 质 量 
工程 小 组 的 架构 师 负 责 开 发 自动 化 测试 工具 ( 包括 现 
在 广泛 用 于 GUI 自动 测试 软件 的 AWT Robot 类 ) ， 期 间 
参与 了 OpenJDK 和 JDK-Distros 项 目的 启动 ， 举 办 了 世 
界 性 的 Mustang Regressions 大 赛 ， 让 Java 开 发 者 社区 
寻找 Java 1.6 的 bug。 

任职 Sun 公 司 之 前 ， 他 曾 为 VXtreme 公 司 开发 视频 
流 处 理工 具 ( Windows Media Player 的 前 身 ) ,在 
Wollongong 集 团 从 事 电 子 邮 件 客户 端 和 服务 器 软件 的 
开发 ， 加 入 了 互联 网 工程 任务 组 ， 负 责 改进 与 电子 邮 
件 相关 的 协议 。 


圭 学 器 

阿里 云云 手机 开发 者 运营 负责 人 ， 曾 在 网 易 做 过 
Ul 设计 师 ， 在 雅虎 中 国 领 导 过 前 端 团队 ， 在 口碑 网 领 
导 过 UED 团 队 ， 还 担任 D2 前 端 技 术 论 坛 顾问 。 对 Web 
标准 、 前 端 开发 模式 、 性 能 优化 和 自动 化 有 和 较 深入 的 
研究 。 目 前 专注 于 从 Mobile 到 PC 领域 的 设计 、 技 术 和 
业务 间 的 结合 ， 常 用 ID : 秦 歌 、 三 七 。 其 译 著 有 
《JavaScript 语 言 精粹 》 和 《高 性 能 网 站 建设 进 阶 指 
南 : Web 开 发 者 性 能 优化 最 佳 实 践 》， 个 人 博客 是 
dancewithnet.com，Twitter 账 号 是 @kavenyan。 


吴 天 豪 

阿里 云 计 算 前 端 开发 工程 师 ，w3ctech 杭 州 站 负责 
人 ，w3ctech.com 内 容 贡献 者 ， 负 责 过 口碑 网 产品 线 的 
开发 、 基 于 移动 浏览 器 的 Web App 开 发 ， 致 力 于 构建 
快速 、 高 效 、 可 访问 性 高 的 Web 应 用 。 


康健 

阿里 云 资深 前 端 开发 工程 师 ， 有 多 年 Flash 平 台 开 
发 经 验 ， 喜 欢 奔放 的 脚本 语言 ， 曾 在 D2 论坛 和 HTML5 
研究 小 组 线 下 沙龙 做 过 技术 分 享 ， 目 前 主要 研究 和 实 
践 Web 技 术 在 移动 平台 上 的 应 用 。 
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Node 是 一 个 服务 器 端的 JavaScript 解释 器 ， 是 构建 快速 响应 、 高 度 可 扩 


台 。Node 使 用 事件 驱动 和 非 阻 塞 的 IO 模型， 








内 容 提 要 

















eBay、Linkedm 、 雅 虎 等 世界 知名 公司 及 网 站 均 有 使 用 Node 的 成 功 案例 。 


本 书 是 基于 Node 开发 Web 应 用 的 实 月 




















网 络 应 用 的 轻 量 高 效 的 平 
非常 适合 数据 密集 、 对 实时 响应 要 求 高 的 分 布 式 应 用 。 微 软 、 








有 指南， 全 书 共 分 6 章 ， 通 过 示例 详尽 介绍 了 Node 的 背景 、 原 理 及 














应 用 方法 。 全 书 内 容 涉 及 Node 简介 、Node 安装 、Node 模块 、 实 现 不 同 版 本 的 简单 应 用 、 实 现 简 单 的 Web 服 





务 器 和 EventEmitter， 以 及 数据 存储 和 检索 。 男 外 ， 本 书 涵盖 了 Node 服务 器 端 开发 的 
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审 稿 人 介绍 


Blagovest Dachev” 2002 年 起 开始 编写 Web 软 件 ， 从 事 过 各 种 各 样 的 开发 工作 ， 从 HTML、 
CSS 、JavaScript 开 发 开始 ， 后 转 站 服务 器 和 数据 库 领 域 。 他 很 早 就 加 入 了 Node.js 开 发 行列 ， 
并 已 经 为 多 个 开源 项 目 做 出 贡献 ， 现 在 是 Dow Jones &Company 的 一 名 软件 工程 师 ， 致 力 于 开 
发 小 工具 框架 ， 为 第 三 方 提供 在 自己 网 站 上 搜索 和 展示 新 闻 的 功能 。 

他 曾 就 读 于 马萨诸塞 大 学 安 姆 斯 特 分 校 ,并 在 那儿 参与 了 信息 检索 方面 的 研究 ,两 次 参与 “ 谷 
歌 编程 之 夏 ”( Google Summer of Code ) 活动 ， 日 与 他 人 合 著 了 几 篇 论文 。 







































































的 力量 ; 感谢 父亲 给 了 我 一 个 幸福 快乐 的 童年 。 





我 想 感谢 我 的 母亲 Tatiana, 谢谢 她 给 我 的 爱 ， 对 我 的 无 私 奉献 ， 还 有 多 年 来 一 直 激 励 我 前 进 
; 感 


Matt Ranney 他 很 时 就 采用 并 参与 开发 Node.js， 且 是 Voxer (使 用 Node 作 为 后 台 服 务 
器 ) 的 创建 者 之 一 。 


致谢 


我 想 感谢 很 多 人 。 

感谢 母亲 Evelyn 为 我 做 的 一 切 ， 感 谢 父 亲 Jim、 姐 姐 Patti 、 哥 哥 Ken。 如 果 没 有 你 们 ， 真 不 敢 
想象 我 的 生活 会 是 个 什么 样子 。 

感谢 女友 Maggie 一 直 以 来 对 我 的 陪伴 ,给 我 的 鼓励 和 信赖 , 她 聪明 睿智 ,总 能 在 适当 的 时 候 
为 我 打气 。 希 望 我 们 能 永远 在 一 起 。 

感谢 肯塔基 大 学 的 Ken Kubota 博 士 对 我 的 信任 ， 是 他 给 了 我 第 一 份 与 计算 机 相关 的 工作 。6 
年 来 ， 我 不 仅仅 学 到 了 计算 机 系统 维护 技巧 ， 还 学 到 了 很 多 其 他 知识 。 

感谢 我 的 前 老板 ， 感谢 肯塔基 大 学 数学 科学 系 、Wollongong 和 集团 、MainSoft、VXtreme、Sun 
Microsystems 和 雅虎 公司 ， 还 有 每 一 位 曾 和 我 一 起 工作 的 同事 。 非 常 感谢 我 的 前 任 经 理 Tina Su， 
是 她 不 断 鼓 励 我 公开 演讲 和 撰写 文章 , 这 对 于 一 个 内 向 的 软件 工程 师 而 言 绝 非 易 事 。 非常 感 谢 雅 
虎 给 我 机 会 参与 其 内 部 的 Node.js 项 目 开 发 ， 并 能 够 照顾 我 写作 本 书 的 需要 。 

感谢 Packt Publishing 给 我 写 书 的 机 会 和 给 予 的 专业 指导 ， 让 我 认识 到 写 书 是 我 的 梦想 。 

感谢 Ryan Dahl、Isaac Schlueter 和 其 他 Node 核 心 团队 成 员 ， 是 他 们 的 智慧 和 眼光 造就 了 如 此 
有 趣 易 用 的 软件 开发 平台 。 在 诸多 同类 平台 中 ，Node 独 树 一 帜 ， 它 既 强 大 又 好 用 ， 实 现 这 么 棱 
的 平台 需要 极 宽广 的 眼界 。 
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欢迎 光临 Node( 也 叫 Nodejs ) 开发 的 世界 。Node 是 一 种 新 兴 的 软件 开发 平台 , 它 将 JavaScript 
从 Web 浏 览 需 移 植 到 常规 的 服务 器 端 。Node 运 行 在 Chrome 的 高 速 V8 引 警 上 ， 并 附带 了 一 个 快速 、 
健壮 的 异步 网 络 MO 组 件 库 。Node 主 要 用 于 构建 高 性 能 、 高 可 扩展 的 服务 器 和 客户 端 应 用 ， 以 实 
现 真正 “实时 的 Web 应 用 ”。 

在 经 过 数 年 尝试 用 Ruby 和 其 他 语言 实现 Web 服 务 器 组 件 之 后 ，Ryan Dahl 在 2009 年 开发 了 
Node 平 台 。 这 个 探索 使 他 从 使 用 传统 的 、 基 于 线程 的 并 发 模型 转向 使 用 事件 驱动 的 异步 系统 ， 
为 后 者 更 简单 ( 多 线程 系统 以 难于 开发 著称 ), 系统 开销 更 低 ( 与 对 每 个 连接 维护 一 个 线程 相 比 )， 
因而 能 提高 相应 的 速度 。Node 旨 在 提供 一 个 “创建 可 扩展 网 络 服务 器 的 简单 方式 ”。 这 个 设计 受 
到 了 Event Machine (Ruby ) 和 Twisted 框 架 (Python ) 的 影响 ， 并 和 它们 有 些 类 似 。 

本 书 致力 于 讲述 如 何 用 Node 构 建 Web 应 用 ,我 们 会 在 书 中 介绍 快速 学 习 Node 时 一 些 必需 的 重 
要 概念 。 本 书 会 教 你 编写 真正 的 应 用 ,剖析 其 工作 原理 ,并 讨论 如 何在 程序 中 应 用 这 些 理念 。 我 
们 需要 安装 Node 和 npm， 学 习 安 装 和 开发 npm 包 及 Node 模 块 。 此 外 , 我们 还 会 开发 一 些 应 用 , 度 
量 长 时 间 运 行 的 计算 在 Node 的 事件 循环 中 的 响应 能 力 ,介绍 将 高 负载 的 工作 分 派 到 多 个 服务 器 的 
方法 ， 并 介绍 Express 框 架 。 


本 书 内 容 


第 1 章 “Node 入 门 ”, 介绍 了 Node 平 台 。 这 一 章 讲述 了 Node 的 用 途 、 技 术 构 架 上 的 选择 、Node 
的 历史 和 服务 器 端 JavaScript 的 历史 ， 然 后 介绍 为 什么 JavaScript 仍 将 受 困 于 浏览 

第 2? 章 “安装 并 配置 Node”， 介 绍 如 何 配置 Node 开 发 环境 ， 包 括 多 种 从 源码 编译 和 安装 的 场 
景 ， 还 会 简单 介绍 在 开发 环境 中 如 何 部 署 Node。 

第 3 章 “Node 模 块 ”, 解释 了 作为 开发 Node 应 用 基本 单位 的 模块 。 我 们 会 全 面 介绍 并 开发 Node 
模块 。 然 后 进一步 介绍 Node 包 管理 器 npm， 给 出 一 些 使 用 npm 管 理 已 安装 包 的 例子 ， 还 将 涉及 开 
发 npm 包 并 将 其 发 布 出 来 供 他 人 使 用 。 

第 4 章 “ 几 种 典型 的 简单 应 用 ”， 在 读者 已 经 有 一 些 Node 基 础 知识 后 ， 开 始 探索 Node 应 用 的 
开发 。 我 们 会 分 别 使 用 Node 、Connect 中 间 件 框架 和 Express 应 用 框架 开发 一 个 简单 的 应 用 。 虽 然 
应 用 比较 简单 , 但 是 我 们 可 以 通过 其 开发 探索 Node 的 事件 循环 , 处 理 长 时 间 的 运算 ， 了 解 异 步 和 
同步 算法 以 及 如 何 将 繁重 的 计算 交 给 后 台 服 务 器 。 
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第 5 章 “ 简 单 的 Web 服 务 器 、EventEmitter 和 HTTP 客 户 端 "， 介 绍 了 Node 里 的 HTTP 客 户 端 和 
服务 器 对 象 。 我 们 会 在 开发 HTTP 服 务 器 和 客户 端 应 用 的 同时 全 面 深入 介绍 HTTP 会 话 。 

第 6 章 “ 存 取 数 据 ”， 探 讨 大 部 分 应 用 都 需要 的 长 期 可 靠 的 数据 存储 机 制 。 我 们 会 用 SQL 和 
MongoDB 数 据 库 引擎 实现 一 个 应 用 。 在 此 期 间 ， 我 们 将 用 Express 框 架 实 现 用 户 验证 ， 更 好 地 展 
示 出 错 页 面 。 


阅读 要 求 


目前 , 我 们 一 般 会 采用 源码 的 方式 安装 Node, 这 种 方式 可 以 很 好 地 用 在 类 Unix 和 符合 POSIX 
标准 的 系统 上 。 当 然 , 在 接触 Node 之 前 , 谦逊 的 心态 是 必需 的 , 但 最 为 重要 的 事情 还 是 让 大 脑 供 
血 充 足 。 

从 源码 安装 的 方式 需要 一 个 类 Unix 或 类 POSIX 系 统 ( 比如 Linux、Mac、 FreeBSD、OpenSolaris 
等 )、 新 的 C/C++ 编译 嚣 、OpenSSL 库 和 Python 2.4 或 更 新 版 本 。 

Node 程 序 可 以 用 任何 文本 编辑 器 来 写 , 不 过 一 个 能 处 理 JavaScript、HTML 、CSS 等 的 文本 纤 
辑 器 会 更 有 帮助 。 

尽管 本 书 介绍 的 是 Web 应 用 开发 ， 但 你 并 不 需要 拥有 一 个 Web 服 务 器 。Node 有 上 自己 的 Web 服 
务 器 套件 。 


读者 对 象 


本 书写 给 所 有 想 在 一 个 新 的 软件 平台 上 开拓 新 编程 模式 的 软件 工程 师 。 

服务 器 端 程序 员 或 许 能 看 到 一 些 新 奇 的 概念 ， 对 Web 应 用 开发 产生 新 的 理解 。JavaScript 是 一 
门 强大 的 语言 ，Node 的 异步 特性 发 挥 了 JavaScript 的 优势 。 

浏览 器 端 JavaScript“ 攻 城 师 ”或 许 会 觉得 在 Node 中 使 用 JavaScript 和 编写 与 DOM 操 作 无 关 的 
JavaScript 代 码 很 有 趣 。( Node 平 台 上 没有 浏览 器 ， 所 以 也 没有 DOM， 除 非 你 安装 JSDom。 ) 

虽然 本 书 各 章 内 容 由 浅 入 深 ， 循 序 渐进 ， 但 到 底 如 何 阅读 本 书 悉 听 尊 便 。 

本 书 需要 读者 知道 如 何 编写 软件 ， 并 且 对 JavaScript 等 编程 语言 有 所 了 解 。 


排版 约定 


在 本 书 中 ， 读 者 会 发 现 不 同 的 文本 样式 。 下 面 是 这 些 样 式 的 示例 和 说 明 。 

正文 中 的 代码 使 用 特殊 字体 :“Pttp 对 象 封装 HTTP 协 议 , 它 的 pttp .createServe 方 法 会 
创建 一 个 完整 的 Web 服 务 器 ， 而 .1isten 方 法 用 于 监听 特定 的 端口 。 

代码 块 是 这 样 的 : 

var http = require('http'); 

http.createServer (function (req, res) { 


res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end('Hello World\n'); 



























































































































































下 载 示例 代码 3 





}) listen(8l24, "127.0.0.1"7)s 
console.log('Server running at http://127.0.0.1:8124/'); 


代码 块 中 会 加 粗 突出 显示 代码 ， 这 表示 需要 读者 格外 注意 : 


Var util = require('util'); 

var A = "a different value A"; 
var B = "a different value B"; 
Var ml = require('./modulel'); 


util.1og('A='+A1' B='+B+' values='+util.inspect (ml.values())); 

命令 行 的 输入 输出 是 这 样 的 : 

$ sudo /usr/sbin/update-rc.d node defaults 

新 术语 及 重要 词汇 都 会 加 粗 显 示 。 你 将 在 屏幕 上 看 到 的 文字 ， 比 如 菜单 或 对 话 框 中 的 文字 ， 
会 这 样 在 正文 中 提 到 :“ 一 个 真正 安全 的 系统 至 少 会 有 用 户 名 和 密码 输入 框 。 不 过 ， 我 们 这 里 就 
直接 让 用 户 单 击 Login 按 钮 了 。” 


读者 反馈 


我 们 始终 欢迎 来 自 读者 的 反馈 意见 。 我 们 想 知 道 读者 对 本 书 的 看 法 , 读者 喜欢 哪些 内 容 或 不 
喜欢 哪些 内 容 。 读 者 真正 深 有 感触 的 反馈 ， 对 于 我 们 开发 图 书 产品 至 关 重 要 。 

一 般 的 反馈 可 以 发 邮件 到 feedback@packtpub.com， 但 请 在 邮件 标题 中 注 明 相关 书 名 。 

如 果 有 关于 新 书 的 建议 ， 你 可 以 登录 www.packtpub.com， 填 写 SUGGEST A TITLE 表 单 或 者 
向 suggest@packtpub.com 发 送 邮件 。 

如 果 你 在 某 个 领域 积累 了 丰富 的 经 验 , 想 写 一 本 书 , 或 者 愿意 与 人 合 车 或 审 校 某 本 书 , 请 阅 
读 www.packtpub.comy/authors 上 的 作者 指南 。 


读者 服务 


现在 你 已 是 Packt 引 以 为 荣 的 读 考 了， 因此 我 们 特别 要 交待 几 件 事 ， 以 保障 你 作为 读者 的 最 
大 权益 O 


下 载 示 例 代码 


在 www.packtpub.com 通 过 自己 的 账号 购买 图 书 的 读者 ， 可 以 下 载 所 有 已 购买 图 书 的 代码 "。 
如 果 这 本 书 是 你 在 其 他 地 方 购 买 的 ， 访 问 www.packtpub.com/support 并 注册 ， 我 们 将 通过 电子 邮 
件 将 相关 文件 发 送 给 你 。 
























































Q 本 书 的 代码 文件 也 可 在 图 灵 社 区 (ituring. com. cn ) 本 书 网 页 免费 注册 下 载 。 一 一 编者 注 





勘误 


虽然 我 们 会 全 力 确 保本 书 内 容 的 准确 性 ,但 错误 仍 在 所 难免 ,如 果 你 发 现 了 本 书 中 的 错误 ( 包 
括 文字 和 代码 错误 )， 而 且 愿 意向 我 们 提交 这 些 错误 ， 我 们 会 十 分 感激 。 这 样 一 来 ， 不 仅 可 以 减少 
其 他 读者 的 疑虑 ， 也 有 助 于 本 书后 续 版 本 的 改进 。 要 提交 错误 ,请 访问 www. packtpub.com/support， 
选择 相关 图 书 ， 单 击 errata submission form 链 接 ， 然 后 输入 勘误 信息 。 经 过 验证 后 ， 你 提交 的 勘误 
信息 就 会 添加 到 已 有 的 勘误 列表 中 。 要 查看 已 有 的 勘误 信息 ， 请 访问 www.packtpub.com/support 并 
选择 相关 图 书 。 


反 盗 版 声 阴 

网 上 各 种 形式 的 盗版 是 一 直 存 在 的 问题 。Packt 非 常 重视 版 权 和 许可 证 的 保护 。 如 果 你 在 网 
上 遇 到 以 任何 形式 非法 复制 的 我 方 作品 , 请 尽快 告知 我 们 相关 的 地 址 或 网 站 名 称 ， 以 便 我 们 采取 
补救 措施 。 

请 把 邮件 发 送 到 copyright@packtpub.com， 并 在 邮件 里 广 明 涉嫌 侵权 资料 的 链接 。 


UL 


感谢 你 帮助 我 们 保护 作者 和 我 们 为 你 带 来 有 价值 内 容 的 能 力 。 
疑难 解答 


如 果 对 本 书 的 某 些 方面 有 疑问 ， 请 将 电子 邮件 发 送 到 questions@packtpub.com， 我 们 会 尽力 
解决 。 
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无 论 开 发 Web 应 用 、 应 用 服务 器 、 任 何 类 型 的 网 络 服务 器 或 客户 端 还 是 通用 编程 , Node 都 是 
一 个 令 人 兴奋 的 新 平台 。 它 把 异步 /JO 和 服务 器 端 JavaScript 巧 妙 地 组 合 在 一 起 , 聪明 地 运用 了 
强大 的 JavaScript 匿 名 函数 和 单线 程 执行 的 事件 驱动 架构 ， 是 专 为 网 络 应 用 的 极 高 扩展 性 而 设 
计 的 。 

Node 模 型 与 大 规模 使 用 线程 的 普通 应 用 服务 器 平台 截然 不 同 。 由 于 使 用 事件 驱动 架构 , 内 存 
占用 量 低 ， 知 吐 量 高 ， 且 编程 模型 更 简单 。Node 平 台 正 处 于 高 速成 长 阶段 ， 很 多 人 使 用 Node 就 
是 为 了 替代 传统 方法 (使 用 Apache、PHP、Python 等 )。 

Node 的 核心 是 一 个 独立 的 JavaScript 虚 拟 机 ， 通 过 扩展 之 后 可 适用 于 通用 编程 ， 并 明确 地 专 
注 于 应 用 服务 器 开发 。Node 平 台 和 开发 Web 应 用 的 常用 编程 语言 (PHP 、Python 、Ruby 、Java 等 ) 
不 是 一 类 东西 ， 与 那些 向 客户 端 提供 HTTP 协议 的 容 需 (Apache 、Tomcat 、Glassfish 等 ) 也 没有 
直接 可 比 性 。 而 且 ， 很 多 人 认为 它 非常 有 可 能 取代 传统 的 Web 应 用 开发 相关 技术 。 

Node 实 现 以 非 阻 塞 的 VO 事件 循环 机 制 和 文件 与 网 络 1/O 库 为 中 心 ， 一 切 都 以 (来 自 Chrome 
浏览 器 的 ) V8 JavaScript 引 擎 为 基础 。 这 个 1/O 库 是 以 实现 采用 任何 TCP 或 UDP 协 议 的 、 任 意 类 型 
的 服务 器 ,无论 是 DNS 服 务 器 ,还 是 采用 HTTP、IRC、FTP 服 务 妖 。 虽 然 它 支 持 针 对 任何 网 络 协 
议 开发 服务 器 或 客户 端 ， 但 最 常用 于 构建 普通 网 站 ， 这 种 情况 下 可 以 取代 像 Apache/PHP 或 Rails 
这 样 的 框架 。 

本 书 将 向 你 介绍 Node。 我 们 假定 你 已 知道 如 何 编写 软件 、 熟 悉 JavaScript， 且 对 如 何 用 其 他 
语言 开发 Web 应 用 有 所 了 解 。 我 们 将 以 开发 实际 应 用 为 例 ， 因 为 阅读 实际 的 代码 是 最 好 的 学 习 
方式 。 


1.1 Node 能 做 什么 


Node 是 脱离 浏览 器 编写 JavaScript 应 用 的 平台 。 这 里 的 JavaScript 并 非 我 们 在 浏览 器 中 熟悉 的 
JavaScript，Node 没 有 内 置 DOM， 也 没有 任何 浏览 器 的 功能 。 但 它 使 用 JavaScript 语 言 和 异步 IO 
框架 ， 是 一 个 强大 的 应 用 开发 平台 。 

Node 无 法 用 于 实现 桌面 GUI 应 用 。 目 前 Node 既 没有 内 置 相当 于 Swing (或 SWT ) 的 功能 组 
























































































































































2 第 1 章 Node 入门 








件 "， 也 没有 Node 扩 展 GUI 工 具 包 ， 而 且 不 能 内 租 到 Web 浏 览 器 中。 如 果 有 可 用 的 GUI 工 具 包 ， 

Node 就 能 用 于 构建 桌面 应 用 。 一 些 项 目 已 经 开始 为 Node 创 建 GTK 绑 定 ”， 它 能 提供 一 个 跨 平台 的 

GUI 工 具 包 。Node 使 用 的 V8 引擎 带 有 一 个 扩展 API[， 人 允许 编 入 C/C++ 代码 以 扩展 JavaScript 或 集成 

原生 代码 库 。 
除了 能 原生 执行 JavaScript 外 ，Node 捆 绑 的 模块 还 能 提供 如 下 功能 : 

口 命令 行 工 具 ( shell 脚 本 风格 ); 

口 交互 式 TTY 风 格 编程 ( REPL ”); 

口 出 色 的 进程 控制 函数 能 监控 子 进程 ; 

口 用 Buffer 对 象 处 理 二 进 制 数 据 ; 

口 使 用 全 面 事 件 驱 动 回调 函数 的 TCP 或 UDP 套 接 字 ; 

口 DNS 查找 ; 

口 基于 TCP 库 的 HTTP 和 HTTPS 客 户 端 /服务 器 ; 

口 文件 系统 的 存 取 ; 

口 内 置 了 基于 断言 的 单元 测试 能 

Node 的 网 络 层 是 底层 ,但 易于 使 用 ,例如 ,HTTP 模 块 可 以 让 你 仅 用 几 行 代码 编写 出 一 个 HTTP 

服务 器 ( 客户 端 )， 但 这 层 让 程序 员 非 常 贴近 协议 的 要 求 ， 且 让 你 精确 控制 将 返回 的 请 求 响应 的 

HTTP 头 。PHP 程 序 员 通常 不 需要 关心 HTTP 头 ， 但 Node 程 序 员 需要 。 

换 句 话说 ， 用 Node 编 写 HTTP 服 务 右 非常 容易 ， 但 通常 Web 应 用 开发 者 不 需要 在 这 种 细节 
层面 上 费 神 。 例如， 由 于 Apache 已 经 存在 ，PHP 程 序 员 就 不 需要 实现 其 HTTP 服 务 器 部 分 了 。 
Node 社 区 已 经 开发 出 许多 类 似 于 Connect 的 Web 应 用 框架 ， 让 开发 者 能 够 快速 配置 可 提供 所 有 
基础 内 容 ( 会话 、cookie 、 静 态 文件 和 日 志 等 ) 的 HTTP 服 务 器 ， 从 而 把 时 间 和 精力 都 放 在 业务 
逻辑 上 。 


















































服务 器 端 JavaScript 

有 点 不 耐烦 了 ? 你 正 一 边 播 头 一 边 抱 怨 :“ 在 服务 器 上 用 一 门 浏览 器 语言 做 什么 ? ”实际 上 ， 
JavaScript 在 浏览 絮 之 外 有 着 悠久 且 大 量 鲜 为 人 知 的 历史 。JavaScript 就 像 其 他 语言 一 样 是 一 门 编 
程 语言 ， 而 你 的 问题 可 能 应 该 这 样 :“ 为 什么 JavaScript 会 一 直 被 困 在 浏览 器 中 ?” 












































Q@ Swing 是 一 个 为 Java 设 计 的 工具 包 , 是 Java 基 础 类 的 一 部 分 ， 具体 见 http://zh.wikipedia.org/wiki/Swing_(Java)。SWT 
(Standard Widget Toolkit ) 最 初 由 IBM 开 发 ， 是 一 套用 于 Java 的 GUI 系统 ， 用 来 和 Swing 竞争 ， 而 开源 集成 开发 环 
境 Eclipse 就 是 用 Java 和 SWT 开 发 的 ， 具 体 见 http://en.wikipedia.org/wiki/Standard Widget Toolkit。( 本 书 脚注 车 无 
特殊 说 明 均 为 译 者 注 。 ) 

@ GTK+ 使 用 C 语 言 开发 ,是 类 Unix 系 统 下 开发 GUI 应 用 程序 的 主流 开发 工具 之 一 。 它 是 自由 软件 , 并 是 GNU 计 划 的 

部 分 ， 具体 见 http://zh.wikipedia.org/wiki/GTK。 

(8) REPL 就 是 Read-Eval-Print Loop 的 缩写 ， 意 思 是 “阅读 -评估 -打印 -循环 ”， 它 既 可 以 作为 独立 的 程序 运行 ， 也 很 
容易 作为 程序 的 一 部 分 使 用 。 它 为 运行 JavaScript 脚 本 和 查看 结果 提供 了 一 种 交互 方式 ,详细 内 容 见 
http://nodejs.org/docs/v0.6.6/api/repl.html 和 http://nodejs.org/docs/v0.6.6/api/tty.html。 




















































































































1.2 为 什么 要 使 用 Node 3 





Web 诞 生 之 初 , 编写 Web 应 用 的 工具 还 不 够 成 熟 。 有 些 人 尝试 用 Perl 或 TCL 编 写 CGI 肢 本, PHP 
和 Java 语 言 刚 刚 被 开发 出 来 ， 而 JavaScript 甚 至 也 被 用 于 服务 需 端 。Netscape 的 LiveWire 服 务 端 作 
为 早期 的 Web 应 用 服务 器 ， 就 是 用 JavaScript 编 写 的 。 微 软 ASP 的 某 些 版 本 使 用 的 是 JScript 一 一 它 
们 自己 的 JavaScript 实 现 。 最 近 的 一 个 服务 器 端 JavaScript 项 目 是 在 Java 领 域 中 使 用 的 RingoJS 应 用 
框架 。RingoJS 构 建 于 Rhino" 之 上 ，Rhino 是 一 个 用 Java 编 写 的 JavaScript 实 现 。 

Node 带 来 了 一 个 前 所 未 见 的 组 合 , 那 就 是 高 速 事件 驱动 TO 和 V8 高 速 JavaScript 引 | 擎 ; V8 这 个 
超 快 的 JavaScript3| 擎 是 Google Chrome 浏 览 器 的 核心 。 


1.2 为 什么 要 使 用 Node 


JavaScript 由 于 无 处 不 在 的 浏览 器 而 非常 流行 。 它 实现 了 许多 现代 高 级 语言 的 概念 ,， 比 其 他 任 
何 语言 都 不 逊色 。 多 亏 了 它 的 普及 ， 软 件 行业 才 有 大 量 经 验 丰富 的 JavaScript 人 才 储 备 。 

JavaScript 是 一 门 动态 编程 语言 , 拥有 松散 类 型 日 可 动态 扩展 的 对 象 ( 能 按 需 非 正 式 地 声明 )。 
函数 是 一 级 对 象 , 通常 作为 匿名 闭 包 使 用 。 这 使 得 JavaScript 比 其 他 常用 于 编写 Web 应 用 的 语言 
加 强大 。 理论 上 ,这 些 特性 使 开发 者 的 工作 更 加 高 效 。 平 心 而 论 ， 动态 和 非 动态 、 静 态 类 型 和 松 
散 类 型 语言 之 间 的 优 劣 沿 无 定论 ， 而 且 可 能 永远 不 会 有 定论 。 

JavaScript 的 一 个 短 板 是 全 局 对 象 。 所 有 的 顶级 变量 都 被 扔 给 一 个 全 局 对 象 , 这 在 混用 多 个 模 
块 时 会 导致 难以 预料 的 混乱 。 由 于 Web 应 用 通常 有 大 量 的 对 象 ， 且 很 可 能 是 多 个 组 织 编写 的 ， 所 
以 你 自然 会 认为 Node 编 程 中 的 全 局 对 象 冲突 会 是 个 “ 雷 区 ”。 但 其 实 不 然 ，Node 使 用 CommonJS” 
模块 系统 ， 这 意味 着 模块 的 局 部 变量 即使 看 起 来 像 全 局 变量 , 实际 上 也 是 局 部 变量 。 这 种 模块 间 
的 清晰 分 离 避 免 了 全 局 对 象 的 问题 。 

在 Web 应 用 服务 器 端 和 客户 端 使 用 同样 的 编程 语言 是 人 们 由 来 已 久 的 梦想 。 这 个 梦想 可 以 追 
漳 到 早期 的 Java 时 代 ， 那 时 Applet 是 用 Java 编 写 的 服务 器 应 用 的 前 端 ， 而 对 JavaScript 的 最 初 设想 
是 将 其 作为 Applet 的 一 种 轻 量 级 脚本 语言 。 但 世事 难 料 ， 到 头 来 JavaScript 取 代 Java 成 为 在 浏览 器 
中 使 用 的 唯一 语言 。 有 了 Node， 在 客户 端 和 服务 器 端 使 用 相同 编程 语言 的 梦想 终于 有 望 实 现 了 ， 
这 门 语言 就 是 JavaScript。 

语言 在 前 后 端 通用 有 如 下 几 个 优势 : 
口 网 线 两 端 可 能 是 相同 的 程序 员 ; 
口 代码 能 更 容易 地 在 服务 器 端 和 客户 端 间 迁 移 ; 





















































































































































Q@ Rhino 是 用 Java 编 写 的 JavaScript 引 擎 ， 其 设计 目标 是 借助 于 强大 的 Java 平 台 API 简 化 JavaScript 程 序 的 编写 。Rhino 
是 Mozilla 开 发 的 自由 软件 ,其 最 新 的 1.7r3 版 本 实现 了 部 分 ECMAScripts,， 可 以 从 http:/www.mozilla.org/rhino/ 下 载 
它 的 源 代 码 。 

@ CommonJS 是 一 种 规范 ，Node 实 现 了 这 个 规范 。JavaScript 是 一 门 强大 的 、 面 向 对 象 的 语言 ， 它 有 很 多 快速 高 效 的 
解释 器 。JavaScript 标 准 定义 的 API 是 为 了 构建 基于 浏览 器 的 应 用 程序 ， 不 存在 用 于 更 广泛 应 用 程序 的 标准 库 。 
CommonJS 定 义 了 构建 很 多 普通 应 用 程序 ( 主要 指 非 浏览 器 应 用 ) 的 API， 从 而 填补 了 这 个 空白 。CommonJS 的 终 
极目 标 是 提供 一 个 类 Python 、Ruby 和 Java 的 标准 库 。 这 样 的 话 ， 开 发 者 可 以 使 用 CommonJS API 编 写 应 用 程序 ， 然 
后 这 些 应 用 可 以 运行 在 不 同 的 JavaScript 解 释 髓 和 不 同 的 主机 环境 中 。 更 多 内 容 见 http:/www.commonjs.org/。 
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口 服务 咒 端 和 客户 端 使 用 相同 的 数据 格式 (JSON ); 

口 服务 器 端 和 客户 端 使 用 相同 的 开发 工具 ; 

口 服务 器 端 和 客户 端 使 用 相同 的 测试 或 质量 评估 工具 ; 

口 当 编 写 Web 应 用 时 ， 视 图 模板 能 在 两 端 共享 ; 

口 服务 器 端 和 客户 端 团 队 可 使 用 相似 的 编程 风格 。 

Node 作 为 一 个 引 人 注 目的 平台 ， 加 上 开发 社区 的 共同 努力 ， 很 容易 把 上 述 这 些 〈 甚至 更 多 ) 
优势 变 成 现实 。 









































1.2.1 架构 问题 : 线程 ， 还 是 异步 事件 驱动 


Node 的 异步 事件 驱动 架构 据说 是 其 拥有 极 高 性 能 的 原因 。 好 吧 ， 应 该 说 还 有 V8 JavaScript3| 
擎 的 巨大 功劳 。 通 常 应 用 服务 器 端 使 用 阻塞 VO 和 线程 来 实现 并 发 。 阻 寨 VO 会 导致 线程 等 待 ， 从 
而 造成 线程 资源 浪费 ， 因 为 当 应 用 服务 器 处 理 请 求 时 ， 需 要 等 待 JO 执 行 结束 才能 继续 处 理 。 
Node 有 一 个 无 需 IO 等 待 或 执行 环境 切换 的 单独 执行 环境 。Node 的 MO 调用 会 转换 为 请 求 处 理 
函数 ,， 当 某 些 数 据 可 用 时 事件 轮 询 会 调度 事件 让 这 些 函 数 工作 。 事 件 轮 询 和 事件 处 理 程序 模型 差 
不 多 , 就 像 浏览 器 中 的 JavaScript 一 样 。 程序 的 执行 最 好 能 快速 返回 到 事件 循环 中 , 以 便 马 上 调度 
下 一 个 可 执行 的 任务 。 

为 了 说 明 这 一 点 ，Ryan Dahl ( 在 他 的 “Cinco de Node” 演 讲 " 中 ) 问 我 们 当 执 行 如 下 代码 时 
会 发 生 什 么 : 

result = query('SELECT * from db'); 

当然 , 在 数据 库 层 把 这 个 查询 发 送 到 数据 库 、 数 据 库 查 询 结 果 并 返回 数据 期 间 , 程序 会 暂停 。 
根据 具体 的 查询 情况 , 暂停 时 间 可 能 相当 长 。 这 非常 糟糕 , 因为 线程 空闲 时 可 以 处 理 另 一 个 请 求 ， 
如 果 所 有 线程 都 繁忙 ( 记 住 计算 机 资源 有 限 )， 请 求 将 被 丢弃 。 这 当然 是 浪费 资源 。 执 行 环境 切 
换 也 不 是 没有 代价 的 ， 使 用 的 线程 越 多 ，CPU 存 储 和 恢复 状态 消耗 的 时 间 就 越 多 。 此 外 ， 每 个 线 
程 的 执行 栈 都 占用 内 存 。 而 是 通过 使 用 异步 事件 驱动 的 /O，Node 会 省 掉 这 里 的 大 部 分 开销 而 其 
自己 带 来 的 开销 却 很 小 。 

用 线程 实现 并 发 通常 面临 类 似 这 样 的 声音 ， 即 “开销 大 易 出 错 ”"、“Java 易 出 错 的 同步 原 语 ” 
或 “设计 并 发 软件 复杂 易 出 错 ”( 实际 上 引号 中 的 内 容 来 自 真实 的 搜索 引擎 结果 )。 复杂 性 来 自 于 
对 共享 变量 的 访问 、 避 免 死 锁 的 各 种 策略 和 线程 间 的 竞争 。 "Java 的 同步 原 语 ”就 是 这 样 一 种 策 
略 ， 显 然 许多 程序 员 发 现 其 难以 实现 ， 因 此 倾向 创建 类 似 java.util.concurrent 这 样 的 框架 
来 解决 线程 并 发 的 问题 ， 但 有 些 人 可 能 会 认为 掩 盖 复 杂 性 并 不 会 使 事情 更 简单 。 

Node 从 不 同 的 角度 解决 并 发 问题 ,通过 事件 轮 询 实现 异步 触发 回调 函数 是 一 种 更 简单 的 并 发 
模型 ， 好 理解 且 好 实现 。 

Ryan Dahl 指 出 理解 读 取 对 象 的 时 间 可 以 帮助 理解 异步 JO 的 重要 性 。 从 内 存 中 读 取 的 对 象 ( 纳 















































































































































@ 这 是 雅虎 主办 的 技术 会 议 ， 在 这 个 会 议 上 Ryan Dahl 介 绍 了 Node。 具 体 情 况 和 视频 见 http://www.yuiblog.com/ 
blog/2010/05/20/video-dahl/。 
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秒 级 ) 比 从 人 硬盘 或 网 络 中 读 取 对 象 ( 室 秒 级 或 秒 级 ) 要 快 很 多 。 读 取 外 部 对 象 的 时 间 非 常 长 ， 当 
用 户 等 待 页 面 加 载 完成 ， 坐 在 浏览 器 前 无 聊 地 移动 鼠标 超过 两 秒 时 ， 这 就 显得 没完 没 了 了 。 

在 Node 中 ， 前 面 的 查询 应 该 这 样 写 : 

query (SELECT * from db', function (result) { 


// 操作 结果 
] 3 


这 些 代码 实现 了 前 面 提 到 的 查询 。 不同 的 是 , 查询 结果 不 是 调用 函数 的 结果 ， 而 是 提供 给 了 
一 个 稍 后 将 调用 的 回调 函数 。 此 时 , 控制 会 立即 返回 事件 循环 , 而 服务 器 能 够 继续 处 理 其 他 请 求 。 
这 些 请 求 中 将 会 有 一 个 是 对 查询 的 响应 , 那么 该 请 求 将 调用 回调 函数 。 这 种 快速 返回 事件 循环 的 
模型 确保 了 更 高 的 服务 器 利用 率 。 对 于 服务 器 的 拥有 者 来 说 这 太 棒 了 , 但 更 大 的 好 处 是 它 能 让 用 
户 更 快 看 到 页 面 内 容 。 

通常 网 页 会 引用 几 十 个 来 源 的 数据 ， 每 个 请 求 都 会 涉及 上 面 讨论 的 查询 和 响应 。 通 过 异步 
查询 ， 它 们 能 并 行 发 生 ， 所 以 页 面 构造 函数 能 同时 发 出 儿 十 个 查询 一 一 无 需 等 待 且 每 个 都 有 自 
己 的 回调 函数 一 一 然后 返回 事件 循环 ， 而 每 个 查询 返回 后 会 调用 相应 的 回调 函数 。 因 为 并 行 ， 
所 以 收集 数据 比 这 些 查 询 一 个 一 个 地 同步 完成 要 快 得 多 。 现 在 用 户 更 高 兴 了 ， 因 为 网 页 打开 得 
更 快 了 。 


1.2.2 ”性 能 和 利用 率 


Node 之 所 以 令 人 兴奋 ， 还 因为 它 的 重 吐 能力 〈 每 秒 能 响应 的 请 求 数 )。 与 相似 的 应 用 ( 比如 
Apache ) 进行 基准 测试 比较 ， 可 以 看 到 Node 的 性 能 提升 很 大 。 
下 面 这 个 简单 的 HTTP 服 务 器 就 是 一 个 基准 测试 程序 ， 它 只 是 返回 “Hello World” 信 息 : 
Var http = require('http'); 
http.createServer (function (req, res) { 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end('Hello World\n'); 


}) listen(8124, T1270:001™7): 
console.log('Server running at http://127.0.0.1:8124/'); 


这 是 用 Node 能 够 构建 的 一 个 简单 的 Web 服 务 器 。http 对 象 封 装 了 HTTP 协 议 ， 其 http . 
createServet 方 法 能 创建 一 个 完整 的 Web 服 务 器 ， 同 时 通过 .1isten 方 法 监听 指定 端口 。Web 
服务 器 上 的 每 个 请 求 (来 自 是 任何 URL 的 GET 或 PUT ) 都 会 调用 这 里 提供 的 函数 ， 就 这 么 简 简单 
单 的 几 行 代码 。 在 这 种 情况 下 , 无 论 是 什么 URL , 它 都 会 返回 一 个 简单 的 Lext /plain 响 应 “Hello 
World 。 

由 于 简单 , 所 以 这 个 应 用 用 以 用 来 度量 Node 请 求 的 最 大 值 吞 吐 量 。 实际 上 许多 已 公布 的 基准 
测试 程序 都 是 从 这 个 最 简单 的 HTTP 服 务 器 开始 的 。 

Node 作 者 Ryan Dah] 演 示 过 一 个 简单 的 基准 测试 程序 ( http://nodejs. org/cinco_de_node.pdf )， 
该 程序 返回 一 个 1 MB 的 缓冲 区 (buffer )，Node 每 秒 能 处 理 822 个 请 求 ， 而 nginx 每 秒 处 理 708 个 。 
他 还 指出 nginx 的 峰值 是 4 MB 内 存 ， 而 Node 是 64 MB。 
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Dustin McQuay (http://www.synchrosinteractive.com/blog/9-nodejs/22- nodejs-has-a-bright-future ) 
演示 了 据 他 所 称 类 似 的 Node 和 PHP/Apache 程 序 : 
口 PHP/Apache 知 吐 量 为 3187 请 求 / 秒 ; 

口 Node.js 吞 吐 量 为 5569 请 求 / 秒 。 

RingoJS 的 作者 Hannes Walln5fer 写 了 一 篇 博文 提醒 大 家 不 要 根据 基准 测试 结果 做 重要 决策 
( http://hns.github. com/2010/09/21/benchmark.html )， 随 后 使 用 基准 测试 程序 比较 了 RingoJS 和 
Node。RingoJS 是 一 个 应 用 服务 器 ， 构 建 在 基于 Java 的 Rhino JavaScript3 引 | 敬之 上 。 取 决 于 应 用 场 
景 ，RingoJS 和 Node 的 性 能 没有 多 大 区 别 。 测 试 结果 表明 对 于 具有 快速 缓冲 区 或 字符 串 分 配 机 制 
的 应 用 ,Node 的 性 能 不 如 RingoJS。 在 后 来 的 一 篇 博文 中 , 他 使 用 解析 JSON 字 符 串 来 模拟 一 个 常 
见 的 任务 ， 并 发 现 RingoJS 表 现 得 更 好 。 

Mikito Takada 发 表 了 关于 基准 测试 和 性 能 改进 的 博文 , 文中 比较 了 基于 Node 构 建 的 “48 hour 
hackathon”( 48 小 时 黑客 马拉松 ) 应 用 (http://blog.mixu.net/2011/01/17/performance-benchmarking- 
the-node-js-backend-of-our-48h-product-wehearvoices-net/ ) 和 一 个 他 声称 使 用 Django 编 写 的 类 似 应 
用 。 未 经 优化 的 Node 版 本 相 比 Django 版 本 有 点 儿 慢 (响应 时 间 长 ), 但 一 些 优化 ( MySQL 连接 池 、 
缓存 等 ) 极 大 地 改进 了 其 性 能 ， 使 其 轻而易举 的 击败 了 Django。 最 终 的 性 能 图 表 显 示 其 性 能 ( 请 
求 数 / 秒 ) 几乎 可 与 之 前 讨论 的 简单 “Hello World” 基 准 测试 程序 相 媲 美 。 

注意 ，Node 应 用 高 性 能 的 关键 是 要 快速 返回 事件 循环 。 我 们 会 在 第 4 章 对 此 进行 详细 介绍 ， 
如 果 回 调处 理 程序 执行 时 间 “ 太 长 ”， 用 Node 也 很 难 成 就 极 快 的 服务 器 。 在 Ryan Dahl 关 于 Node 
项 目的 一 篇 早期 博文 (http://four.livejournal.com/963421.html ) 中 ,他 论述 了 事件 处 理 程序 执行 时 
间 要 小 于 5 ms 的 必要 性 。 这 篇 博文 中 的 大 部 分 想法 都 没有 实现 ， 但 Alex Payne 写 了 一 篇 关于 它 的 
有 趣 博 文 ( http://al3x.net/2010/07/27/mode.html ) 分 析 了 “小 规模 应 用 ”( scaling inthe small ) 和 “大 
规模 应 用 ”( scaling in the large ) 的 区 别 。 

对 于 小 型 Web 应 用 ， 在 用 Node 编 码 取 代 通 常 的 “P” 语 言 (Perl、PHP、Python 等 ) 编码 时 具 
有 性 能 和 实现 上 的 优势 。JavaScript 是 一 门 强大 的 语言 ， 同 时 使 用 现代 高 速 虚拟 机 设计 的 Node 环 
比 像 PHP 这 样 的 解释 语言 更 具 性 能 和 并 发 上 的 优势 。 

在 讨论 “大 规模 应 用 ”时 他 说 ， 企 业 级 应 用 的 编写 总 是 困难 且 复 杂 的 。 典 型 的 企业 级 应 用 都 
会 使 用 负载 均衡 、 缓 存 服务 器 、 大 量 元 余 机 器 ， 这 些 机 器 很 可 能 分 散在 各 个 不 同 的 地 方 , 为 世界 
各 地 的 用 户 提供 快速 的 Web 浏 览 体 验 。 或 许 对 于 整个 系统 来 说 应 用 开发 平台 并 不 那么 重要 。 

在 看 到 Node 被 真正 长 期 实际 地 采用 之 前 ， 很 难 知道 它 真正 的 价值 有 多 大 。 


1.2.3 ”服务 器 利用 率 、 成 本 和 绿色 Web 托管 服务 


追求 最 佳 效率 ( 每 秒 内 处 理 更 多 的 请 求 ) 不 仅仅 是 要 通过 优化 得 到 极 客 一 般 的 满足 感 ， 还 要 
追求 真正 的 商业 和 环境 效益 。 像 Node 服 务 器 那样 , 每 秒 处 理 更 多 的 请 求 就 意味 着 不 必 再 购买 大 量 
的 服务 器 。 本 质 就 是 用 更 少 的 资源 做 更 多 的 事情 。 

大 致 来 说 ,购买 更 多 的 服务 器 ， 就 要 消耗 更 多 电力 和 造成 更 大 的 环境 污染 ,反之 ,服务 右 越 
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少 , 投入 越 少 ， 对 环境 污染 也 越 少 。 对 于 降低 运行 Web 服 务 器 成 本 和 对 环境 的 影响 ， 现 已 存在 一 
个 专业 的 研究 领域 。 这 里 的 目标 相当 明显 : 更 少 的 服务 器 、 更 低 的 成 本 和 更 小 的 环境 污染 。 
英特尔 的 文章 “通过 服务 器 电能 测量 提高 数据 中 心 效率 ”( Increasing Data Center Efficiency 
with Server Power Measurements, http://download.intel.com/it/pdf/Server Power _ Measurement final.pdf ) 
给 出 了 用 于 理解 效率 和 数据 中 心 成 本 的 客观 框架 。 有 许多 因素 ( 诸如 建筑 、 冷 却 系统 和 计算 系统 
设计 ) 都 会 对 成 本 和 环境 产生 影响 。 高 效 的 建筑 设计 、 冷 却 系统 和 计算 机 系统 (数据 中 心 效率 、 
密度 和 存储 密度 ) 能 降低 成 本 和 环境 影响 。 但 你 可 能 因为 部 署 一 个 低 效 的 软件 框架 需要 购买 更 多 
的 服务 器 ， 以 致 毁 掉 这 些 收益 ， 然 而 你 也 可 以 通过 使 用 高 效 的 软件 框架 放大 数据 中 心 的 效率 。 





























1.3 Node、Node.js 还 是 Node .JS 




















这 一 平台 的 名 字 是 Node.js， 但 本 书 使 用 Node 这 个 拼写 形式 ， 因 为 我 们 遵循 了 nodejs.org 网 站 
的 提示 ， 它 说 Node.js (小写 的 .js ) 是 商标 , 但 整 站 都 使 用 Node 这 个 拼写 形式 ， 本 书 也 与 官方 网 站 
保持 一 致 。 





1.4 “小结 


本 章 介绍 了 很 多 知识 ， 具 体 包括 : 
口 JavaScript 在 浏览 器 之 外 亦 有 一 番 天 地 ; 
口 异步 和 阻塞 IO 的 不 同 之 处 ; 
口 关于 Node 的 基本 情况 ; 
口 Node 的 性 能 。 
介绍 完 Node 之 后 ,我 们 准备 深入 讲述 如 何 使 用 它 。 第 2 章 将 讨论 如 何 设置 Node 环 境 ， 准 备 好 
了 吗 ? 














安装 并 配置 Node 








开始 使 用 Node 之 前 ,需要 先 配 置 好 开发 环境 。 后 面 的 几 章 里 我 们 都 会 基于 这 个 环境 进行 开发 ， 
不 过 这 个 配置 不 适用 于 生产 环境 的 部 署 。 


本 章 内 容 

口 了 解 如 何 利 用 源 代 码 在 Linux 和 Mac 上 安装 Node; 
口 了 解 如 何 安装 apm 包 管理 器 和 一 些 常用 的 工具 ; 
口 学 习 一 些 关于 Node 模 块 系统 的 知识 。 














开始 吧 。 


2.1 系统 要 求 


Node 最 适合 在 符合 POSIX" 标 准 的 操作 系统 上 运行 这 些 系统 包括 了 UNIX 的 衍生 系统 ( Solaris 
等 ) 和 通用 计算 机 操作 系统 (Linux-Mac OS X 等 )。 实 际 上 ，Node 内 置 的 很 多 函数 都 是 直接 调用 
POSIX 系 统 的 接口 。 

些 高 级 语言 平台 ( 比如 Perl 和 Python ) 拥有 稳定 的 特性 和 API, 通常 会 被 打包 进 不 同 版 本 的 
操作 系统 。 由 于 Node 还 在 快速 发 展 中 , 将 其 打包 进 操作 系统 可 能 还 为 时 尚 早 。 这 也 意味 着 , Node 
还 只 能 利用 源 代 码 安装 。 

利用 源 代 码 安装 Node 需 要 准备 一 个 C 语 言 编译 器 ( 比如 GCC )， 还 需要 Python 2.4( 或 者 更 新 
版 本 )。 如 果 打 算 对 网 络 操作 加 密 ， 你 还 需要 OpenSSL 加 密 库 。 现 代 的 UNIX 衍 生 系统 大 部 分 都 自 
带 了 这 些 程序 , Node 的 配置 脚本 (在 下 载 并 配置 源 文件 的 时 候 可 以 看 到 ) 会 检测 这 些 程序 是 否 存 
在 。 如 果 你 需要 自己 进行 安装 ， 可 以 在 http://python.org 上 下 载 安 装 Python ， 而 可 以 在 
http://openssl.org 中 找到 并 下 载 安装 OpenSSL。 

虽然 Windows 没 有 兼容 POSIX 标 准 ， 但 我 们 能 通过 在 Windows 上 模拟 POSIX 兼 容 环 境 来 安装 
Node (Node 0.4.x 或 者 更 早 的 版 本 )。 在 0.6.x 或 者 更 新 的 版 本 中 ，Node 开 发 团队 打算 将 Node 开 发 



















































































GD POSIX 是 IEEE 开 发 的 一 系列 互相 关联 的 标准 的 总 称 , 旨 在 为 要 在 各 种 UNIX 操 作 系统 上 运行 的 软件 定义 API, 参见 
http:/en.wikipedia.org/wikiPOSIX。 
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成 可 以 在 Windows 中 直接 安装 的 程序 。 因 为 安装 方式 变化 太 快 , 所 以 本 书 不 会 介绍 如 何在 Windows 
里 安装 Node， 最 新 的 安装 说 明 见 https://github.com/ry/node/wiki/Installation， 其 中 的 Step 3b 部 分 讨 
论 了 如 何 通 过 使 用 Cygwin 或 者 MinGW 在 Windows 上 安装 Node。 安装 好 了 了 Cygwin 或 者 MinGW, 表 
安装 Node 的 步骤 与 在 符合 POSIX 标 准 的 系统 上 是 类 似 的 。 


2.2 在 符合 POSIX 标准 的 系统 上 安装 


现在 你 应 该 已 经 对 安装 Node 大 致 有 些 了 解 , 接 下 来 让 我 们 亲自 体验 下 安装 过 程 。 一 般 情 况 下 ， 
安装 需要 执行 configure、 make、 make install routine 命 令 ， 而 你 应 该 已 经 在 安装 其 他 软 
件 的 时 候 尝 试 过 这 些 操作 了 。 
官方 的 安装 说 明 请 参考 Node 的 wiki 系 统 ， 地 址 是 : 
https://github.com/ry/node/wiki/Installation 


安装 条 件 


前 面 我 们 提 到 ， 安 装 Node 需 要 准备 3 个 程序 ，C 语 言 编译 器 、Python 和 OpenSSL 库 。Node 安 
装 过 程 会 先 检 测 这 些 程序 是 否 已 经 安装 ， 如 果 C 语 言 编译 器 或 者 Python 缺失 ， 安 装 就 会 失败 。 具 
体 安装 这 些 程序 的 方法 因 计 算 机 操作 系统 而 异 。 

下 面 的 命令 可 以 检查 这 些 软件 的 安装 情况 : 


$ cc --version 

i686-apple-darwin10-gcc-4.2.1 (GCC) 4.2.1 (Apple Inc. build 5666) (dot 3) 
Copyright (C) 2007 Free Software Foundation, Inc. 

This is free software; see the source for copying conditions. There is NO 
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
$ python 

Python 2.6.6 (r266:84292, Feb 15 2011, 01:35:25) 

[GCC 4.2.1 (Apple Inc. build 5664)] on darwin 

Type "help", "copyright", "credits" or "license" for more information. 

>>> 






















































































2.3 ”在 MacOSX 上 安装 开发 者 工具 


开发 者 工具 (比如 GCC ) 在 Mac OS X 上 的 安装 是 可 选 的 ， 有 两 种 安装 方案 ， 并 且 都 是 免费 
的 。 安 装 OS X 的 DVD 中 ， 有 一 个 目录 是 “Optional Installs”( 可 选 的 安装 程序 )， 这 个 文件 夹 里 包 
含 了 一 个 软件 包 安 装 程序 ， 用 于 安装 开发 者 工具 ， 包 括 Xcode。 

另外 一 个 方案 是 从 http://developer.apple.com/xcode/ 上 下 载 最 新 版 本 的 Xcode。 



































2.3.1 在 home 目录 下 安装 


以 前 ， 将 Node 安 装 到 home 目 录 下 是 一 个 很 好 的 方式 ， 可 方便 以 后 的 应 用 开发 。 不 过 现在 ， 
Node 0.4.x 或 者 更 新 的 版 本 带 来 了 一 些 变化 ， 特 别 是 npm 1.0 发 布 后 ,我们 已 经 没有 太 大 必要 将 
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Node 安 装 到 home 目 录 下 。 你 可 以 将 Node 安 装 到 系统 级 目录 ( 见 2.3.2 节 )， 或 者 当前 用 户 目录 下 ， 
从 而 方便 开发 或 测试 。 

现在 让 我 们 看 一 看 如 何在 当前 用 户 目录 下 安装 Node。 

(1) 首先 ， 从 http://modejs.org/#download 上 下 载 源 代码 。 你 可 以 通过 浏览 器 下 载 ， 或 者 用 下 面 
的 方式 : 





$ mkdir src 

$ cd src 

$ wget http://nodejs.org/dist/node-v0.4.8.tar.gz 
$ tar xvfz node-v0.4.8.tar.gz 

$ cd node-v0.4.8 





(2) 下 一 步 是 配置 源 代码 以 更 其 可 以 用 于 构建 。 其 中 包括 一 些 典 型 的 配置 脚本 ， 
行 ./configure -help 可 以 看 到 巨 多 的 选项 。 运 行 以 下 命令 可 以 将 Node 安 装 到 ee 


$ ./configure --prefix=$HOME/node/0.4.8 











Checking for program g++ Or C++ : /usr/bin/g++ 
Checking for program cpp : /usr/bin/cpp 
Checking for program ar : /usr/bin/ar 
Checking for program ranlib : /usr/bin/ranlib 





一 段 时 间 后 ,安装 过 程 会 停止 ， 此 时 配置 过 程 大 概 已 经 完成 ,， 源 文件 已 经 可 以 在 你 选择 的 目 
录 下 安装 了 。 如 果 没 有 成 功 的 话 ,， 控制 台 会 打印 出 一 条 消息 ,告诉 你 需要 解决 的 问题 。 如 果 配 置 
脚本 执行 完毕 ， 你 就 可 以 进行 下 一 步 了 。 

(3) 配置 脚本 执行 完毕 ， 就 可 以 对 Node 进 行 编译 了 : 


$ make 
此 处 是 长 长 的 编译 日 志 


$ make install 
(4) 安装 完成 后 ， 你 需要 将 安装 目录 添加 到 PATH 变量 


$ _ echo 'export PATH=$HOME/node/0.4.8/bin:${PATH}' >>~/.bashrc 
$ . ~/.bashrc 


如 果 你 使 用 C shell”"， 要 使 用 的 命令 如 下 : 


$ echo 'setenv PATH S$HOME/node/0.4.8/bin:${PATH}' >>~/.cshrc 
$ source ~/.cshrc 


完成 后 会 生成 一 些 新 目录 : 


$ ls ~/node/0.4.8/ 









































bin include lib share 
$ ls ~/node/0.4.8/bin 
node node-waf 


完成 这 一 步 ， 你 就 可 以 直接 阅读 2.4 节 了 。 





人 C shell 是 Unix shell 的 一 种 ， 由 Bi Joy 在 BSD 系 统 上 开发 ， 参 见 http://zh.wikipedia.org/wiki/C_Shell。 


2.3 在 MacOSX 上 安装 开发 者 工具 11 





为 什么 要 安装 到 home 目 录 

将 Node 安 装 到 home 目 录 主 要 考虑 了 两 个 原因 : 
口 方便 测试 和 开发 ; 

口 安全 性 。 

首先 ， 开 发 者 如 果 考 虑 试验 自己 定制 的 Node 实 例 ， 在 多 个 版 本 的 Node 下 测试 自己 的 应 用 ， 
甚至 直接 修改 Node 的 源 代 码 ， 我 们 推荐 将 Node 安 装 到 home 目 录 下 。 

安全 问题 可 能 不 太 好 理解 ， 让 我 们 慢 慢 分 析 。 

首先 , 假设 在 使 用 类 Unix 系 统 时 , 你 没有 管理 员 权 限 , 但 是 想 要 使 用 Node。 如 果 你 是 在 home 
目录 下 安装 Node 的 话 ， 这 还 是 很 方便 的 。 

其 次 ,在 安装 Node 或 相关 工具 ( 如 npm ) 时 下 载 和 执行 脚本 也 有 风险 。 你 能 确保 这 些 工 具 的 
作者 足够 可 信 吗 ? 0.1.x 或 者 0.2.x* 这 样 的 版 本 号 就 说 明 不 够 稳定 或 不 够 安全 。 无 论 如 何 , 通过 suaqo 
下 载 旧 版 本 的 npm 会 带 来 一 些 麻烦 ， 而 这 就 是 以 说 明 问 题 了 。 

在 npm 1.0 之 前 ， 所 有 的 模块 都 必须 安装 在 Node 实 例 里 。 这 看 起 来 无 伤 大 雅 ， 但 是 当 Node 被 
安装 在 系统 级 目录 下 时 则 不 然 ， 这 时 操作 需要 root 权 限 ， 并 且 在 安装 Node 包 时 会 执行 很 多 脚本 。 
你 可 能 没有 root 权 限 ， 本 地 安全 策略 也 可 能 会 禁止 一 些 乱 七 八 糟 的 软件 以 root 权 限 执行 。 如 果 在 
home 目 录 下 安装 Node， 任 何 破坏 性 的 行为 都 会 被 限制 在 home 目 录 下 。 视 你 好 运 。 

在 Node 0.4.x 和 npm 1.0.x 环 境 下 ， 一 般 推 荐 将 Node 包 安装 到 当前 用 户 目录 下 ， 而 不 是 在 Node 
实例 中 安装 。 这 样 的 安装 过 程 是 不 需要 root 权 限 的 。 

正 因为 如 此 ， 我 们 现在 可 以 在 系统 级 目录 下 以 管理 员 身 份 操作 Node 实 例 。 因 为 Node 拥 有 一 
个 灵活 的 包 查 找 算 法 , 所 以 你 也 可 以 在 当前 用 户 目 录 上 安装 应 用 需要 的 Node 包 。 我 们 会 在 下 一 章 
详细 讲述 这 些 内 容 。 


2.3.2 ”在 系统 级 目录 下 安装 Node 


一 般 情 况 下， 我 们 推荐 你 将 Node 安 装 到 系统 级 目录 下 。 原 因 有 : 

口 这 是 一 个 普遍 的 最 佳 实践 ; 

口 这 样 Node 就 可 以 被 多 个 不 同 应 用 或 者 用 户 共享 ; 

口 在 安装 Node 的 时 候 可 以 避免 不 小 心 履 盖 其 他 文件 的 问题 ; 

口 允许 你 在 系统 启动 的 时 候 启 动 Node 服 务 器 。 

在 系统 级 目录 下 安装 Node 和 在 home 目 录 下 安装 的 过 程 基本 一 致 ， 不 过 有 两 点 不 同 之 处 。 

口 第 一 点 是 选择 安装 目录 的 时 候 。 我 们 用 配置 脚本 来 选择 安装 目录 ， 默 认 情 况 下 会 安装 到 
usr/local 日 录 下 : 


$ ./configure # for /usr/local 
$ ./configure -prefix=/usr/local/node/0.4.8 


基本 上 ， 你 只 需要 选择 目录 并 使 用 configure 命 令 完 成 配置 。 
口 第 二 点 不 同 是 make instal1 步 又 。 由 于 系统 级 目录 大 都 不 允许 普通 用 户 写 入 文件 ， 因 此 
你 需要 取得 root 权 限 并 用 下 面 的 方式 安装 : 
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$ sudo make install 


注意 ， 如 果 Node 的 安装 目录 已 经 在 PATH 环境 变量 中 ， 就 不 需要 重复 修改 了 。 














2.3.3 在 Mac OSX 上 使 用 MacPorts 安装 


使 用 之 前 的 方式 ， 你 也 可 以 将 Node 安 装 到 Mac OS X 系 统 上 。 由 于 Mac OS X 兼 容 UNIX， 
此 这 是 完全 没有 问题 的 。 

MacPorts "项 目 (http:/www.macports.org/ ) 长 久 以 来 一 直 为 Mac OS X 系 统 提 供 一 系列 开源 软 
件 包 ,并 且 打 包 了 Node。 在 你 使 用 其 网 站 上 的 安装 器 安装 了 MacPosts 之 后 ， 安 装 Node 就 是 非常 
简单 的 事 了 。 

$ sudo port search nodejs 

nodejs @0.4.8 (devel, net) 

Evented I/O for V8 JavaScript 


$ sudo port install nodejs 


下 载 并 安装 先决 程序 及 Node 的 长 长 的 日 志 
不 过 ， 不 能 通过 这 样 的 方式 安装 npm。 
























































2.3.4 在 MacOS X 上 使 用 homebrew 安装 


homebrew 是 另外 一 个 Mac OS X 上 的 开源 软件 包 管 理工 具 ， 有 些 人 甚至 认为 它 是 MacPorts 的 
完美 替代 者 。 我 们 可 以 通过 网 站 http://mxcl.github.com/homebrew/ 下 载 安装 homebrew。 按照 网 站 上 
的 说 明 安 装 完成 后 ， 可 以 按照 下 面 的 方式 非常 方便 地 安装 Node: 


$ brew search node 

leafnode node 

$ brew install node 

==> Downloading http://nodejs.org/dist/node-v0.4.8.tar.gz 

并 打 音 提 失 提 打 提 打 音 提 村 打 打 音 打 持 打 失 寺 打 音 提 失 条 打 捍 打 捍 提 村 寺村 捍 打 村 条 林寺 打 捍 打 失 提 打 音 打 捍 提 失 提 打 音 提 捍 并 # 100 . 0% 

==> ./configure --prefix=/usr/local/Cellar/node/0.4.8 

==> make install 
. etc 

$ brew search npm 

npm can be installed thusly by following the instructions at 
http://npmjs.org/ 


npm 也 可 以 通过 上 面 这 样 的 方式 安装 ， 具 体 请 参照 http://npmjs.org/ 上 的 说 明 。 


2.3.5 在 Linux 上 使 用 软件 包 管 理 系 统 安装 


虽然 Linux 或 者 其 他 操作 系统 上 还 不 会 预 装 Node， 但 这 并 不 意味 着 不 能 通过 软件 包 管理 器 安 
装 Node。Node wiki 上 的 说 明 部 分 最 近 就 列 出 了 为 Debian 、Ubuntu 、OpenSUSE 和 Arch Linux 系 统 
打包 好 的 Node 包 。 












































(D MacPorts 曾 经 叫做 DarwinPorts[1]， 是 一 个 软件 包 管理 系统 ， 用 来 简化 Mac OS X 和 Darwin 操 作 系 统 上 软件 的 安装 。 
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读者 可 以 通过 访问 https://github.com/joyent/mode/wiki/Installing-Node.js-via-package-manager 
查看 详细 内 容 。 
在 Debian 下 的 安装 方法 如 下 : 


# echo deb http://ftp.us.debian.org/debian/ sid main > 
/etc/apt/sources.list.d/sid.1list 

# apt-get update 

# apt-get install nodejs # Documentation is great. 


在 Ubuntu 下 的 安装 方法 如 下 : 


sudo apt-get install python-software-properties 
sudo add-apt-repository ppa:jerome-etienne/neoip 
sudo apt-get update 

sudo apt-get install nodejs 


期 待 有 一 天 Linux 和 其 他 操作 系统 能 将 Node 以 类 似 语言 包 的 形式 捆绑 到 OS 中 。 





半音 间 砷 


2.3.6 同时 安装 并 维护 多 个 Node 


通常 你 不 会 同时 安装 Node 的 多 个 版 本 ， 这 样 会 让 系统 变 得 复杂 。 但 是 如 果 在 开发 Node， 或 
者 测试 一 些 不 同 的 Node 版 本 ， 或 者 处 于 一 些 其 他 类 似 的 情况 下 ， 你 可 能 会 安装 多 个 Node。 此 时 ， 
我 们 只 需 对 之 前 的 步骤 稍 作 修改 ， 即 可 安装 多 个 Node。 

之 前 的 安装 说 明 部 分 曾 提 到 过 , -prefix 选 项 可 以 用 于 在 同一 目录 下 并 行 安装 多 个 不 同 版 本 
的 Node: 











$ ./configure --prefix=$HOME/node/0.4.8 

也 可 以 这 样 安装 : 

$ ./configure --prefix=/usr/local/node/0.4.8 

这 一 步 决定 了 Node 的 安装 目录 。 无 论 版 本 是 0.4.9、0.6.1 或 者 其 他 版 本 , 你 依然 可 以 通过 修改 
安装 前 级 同时 安装 多 个 版 本 。 

Node 版 本 之 间 的 切换 可 以 通过 修改 PATH 环 境 变 量 实现 ( 在 符合 POSIX 标 准 的 系统 上 ), 具体 
如 下 : 

$ export PATH=/usr/local/node/0.6.1/bin:s${PATH} 

维护 这 么 多 版 本 有 点 麻烦 。 针 对 不 同 的 版 本 , 你 需要 启动 Node, npm 和 其 他 安装 在 Node 上 的 
第 三 方 模块 。 而 修改 PATH 环境 变量 并 不 是 理想 的 方式 。 别 出 心 裁 的 程序 员 已 经 构建 了 多 版 本 的 
管理 器 , 来 自动 配置 Node 和 npm 并 从 而 简化 了 操作 。 这 个 管理 器 也 提供 了 一 些 命令 用 于 更 智能 地 
修改 PATH 环境 变量 : 
口 https://github.com/visionmedia/n 一 一 Node 版 本 管理 器 ; 
口 https:/github.com/kunomeco 一 一 Nodejs Ecosystem COordinator ( 用 于 Node 环 境 的 协调 )。 
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2.4 验证 安装 成 功 与 否 
现在 已 经 安装 好 Node 了 ， 我 们 需要 做 两 件 事 : 验证 安装 是 否 成 功 ， 熟 悉 命 令 行 工具 。 








2.4.1 Node 命令 行 工具 


用 普通 方式 安装 的 Node 含 有 两 个 命令 node 和 node-waf。 我 们 已 经 在 前 面 看 到 过 noge。 
它 可 以 用 于 运行 命令 行 脚本 或 者 服务 器 进程 。node-waf 命 令 是 一 个 构建 工具 ， 用 于 创建 Node 原 
生 的 扩展 ( 这 部 分 内 容 不 是 本 书 关心 的 ， 所 以 我 们 不 会 在 书 中 提 及 ， 你 可 以 通过 阅读 nodejs.org 
上 的 在 线 文 档 了 解 更 多 信息 )。 

有 一 个 最 简单 的 方式 来 检查 Node 是 否 安装 成 功 ， 同 时 它 也 是 向 Node 获 取 帮 助 的 最 好 方式 。 
输入 下 面 的 命令 : 


$ node --help 
Usage: node [options] script.js [arguments] 


















































Options: 
-Vv, --version print node's version 
--debug [=port] enable remote debugging via given TCP port 
without stopping the execution 
--debug-brk[=port] as above, but break in script.js and 
wait for remote debugger to connect 
--V8-options print v8 command line options 
--vars print various compiled-in variables 


--max-stack-size=val set max v8 stack size (bytes) 


Enviromental variables: 

NODE_PATH ':'-Separated list of directories 
prefixed to the module search path, 
require.paths. 

NODE_DEBUG Print additional debugging output. 

NODE_ MODULE CONTEXTS Set to 1 to load modules in their own 
global contexts. 

NODE_DISABLE COLORS Set to 1 to disable colors in the REPL 

Documentation can be found at http://nodejs.org/ or with 'man node' 


es 了 与 使 用 方法 相关 的 信息 ， 展 示 可 用 的 命令 行 选项 
同时 支持 Node 和 V8 的 命令 行 选 项 (没有 在 上 面 的 命令 行 中 显示 ) 是 存在 的 。 记 住 ， 
人 而 V8 含有 自己 的 选项 域 ， 主 要 针对 字 节 码 编译 或 者 垃圾 回收 的 细节 
和 堆 算 法 。 ne --v8 -options 可 以 看 到 完整 的 命令 列表 。 
在 使 用 命令 行 工具 时 , 你 可 以 指定 命令 行 的 选项 、 单 个 脚本 文件 和 传人 脚本 的 参数 列表 。 我 
Te 
不 带 参数 运行 Node 时 ， 就 会 进入 JavaScript shell 会 话 程 序 : 


$ node 

> console.log('Hello, world!'); 

Hello, world! 

> console.log(JSON.stringify(require.paths)); 
["/Users/davidherron/.node libraries","/opt/local/lib/node"] 
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所 有 可 写 人 Node 脚 本 的 代码 都 可 以 直接 写 在 这 里 。 命 令 解释 器 提供 了 良好 的 终端 体验 , 这 对 
你 玩 代码 非常 有 帮助 。 你 也 玩 代 码 ， 对 吧 ?” 很 好 。 





2.4.2 用 Node 运行 简单 的 脚本 
现在 让 我 们 看 看 如 何 用 Node 运 行 脚本 。 这 个 操作 非常 简单 ， 让 我 们 从 帮助 命令 开始 : 


$ node --help 
Usage: node [options] script.js [arguments] 


上 面 展 示 了 一 个 脚本 文件 名 和 一 些 传 人 脚本 的 参数 ， 这 与 其 他 脚本 语言 很 类 似 。 
首先 创建 一 个 文本 文件 1s .js， 输 入 下 面 的 内 容 : 


Var fs = require('fs'); 

var files = fs.readdirSync('.'); 

for (fn tH fi Les) 
console.log(files[fn]); 


} 








下 载 示 例 代码 
> 你 可 以 下 载 所 有 已 购 Packt 图 书 的 示例 代码 文件 ， 只 要 你 是 在 http://www. 
Q PacktPub.com 上 用 你 的 账号 购买 的 。 如 果 你 在 其 他 地 方 购买 了 本 书 ， 可 以 访问 
http://www.PacktPub. com/support 并 注册 ， 代 码 文件 会 以 邮件 的 形式 发 送 给 你 。 


接 下 来 输入 下 面 的 命令 : 
$ node 1s.Jjs 

app.js 

ls.js 


这 个 命令 比较 简单 地 仿制 了 Unix 系 统 里 1s 命 令 的 功能 。readdirsync 函 数 和 Unix 里 的 
readdir 命 令 功 能 相似 (输入 man 3 reaaddqir 了 解 更 多 ) ， 这 个 函数 可 以 列 出 目录 下 的 所 有 
文件 。 

脚本 的 参数 会 通过 一 个 全 局 的 数组 process.argv 传 递 , 你 可 以 按照 下 面 的 方式 修改 1s .js， 
查看 这 个 数组 的 工作 原理 : 


Var fs = require('fs'); 
Va GLE se 
if (process.argv[2]) dir = process.argv[2]; 
Var files = fs.readdirSync (dir); 
fOr (ET 二 二 | 起 避 让 二 

console.log(files[fn]); 


} 
你 可 以 按照 下 面 的 方式 运行 这 段 脚 本 : 
$ node 1s2.js ../0.4.8/bin 


node 
node-waf 
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2.4.3 用 Node 启动 服务 器 
以 后 你 运行 的 脚本 大 部 分 都 可 能 是 服务 器 进程 。 接 下 来 我 们 也 会 运行 很 多 这 类 脚本 。 因 为 我 


们 现在 只 是 在 验证 和 熟悉 Node， 所 以 这 里 只 给 出 一 个 简单 的 HTTP 服 务 器 。 这 里 借用 了 Node 主 页 
(http:/nodejs.org ) 上 的 服务 器 脚本 。 
创建 一 个 文件 appjs， 包 括 了 下 面 的 内 容 : 
Var http = require('http'); 
http.createServer (function (req, res) { 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end('Hello, World!\n'); 
}) listen(8L247 L2720 0 Ly) 
console.log('Server running at http://127.0.0.1:8124'); 


按照 下 面 的 方式 运行 : 


$ node app.js 
Server running at http://127.0.0.1:8124 


这 是 一 个 用 Node 构 建 的 、 最 简单 的 Web 服 务 器 。 如 果 你 对 它 的 工作 原理 比较 感 兴趣 ,可 以 直 
接 阅读 第 4 章 ~ 第 6 章 。 现 在 ， 你 只 需要 在 浏览 需 里 访问 http:/127.0.0.1:8124 就 可 以 看 到 如 图 所 示 
的 结果 : 




















http://127.0.0.1:8124/ 
4 | 上 请 | | 十 | 加 http:/1127.0.0.1:8124/ ¢ | (Qr Google » 
http://127.0.0.1:8124/ + 


Hello, World! 











这 里 有 一 个 问题 ,为 什么 这 段 脚 本 执行 完毕 后 1s .js 退出 了 ， 而 这 段 脚 本 却 没 有 退出 ”两 个 
脚本 都 执行 到 了 最 后 部 分 ; 在 app .js 里 Node 进 程 没有 退出 ， 而 1s .js 进程 退出 了 。 原 因 在 于 活 
动 的 事件 监听 右 。Node 始 终 会 启动 一 个 事件 循环 ， 在 app .js 里 ，.1isten 函 数 创建 了 一 个 实现 
HTTP 协 议 的 事件 监听 器 。 这 个 事件 监听 融会 使 ppp.js 一 直 处 于 执行 状态 ， 直 到 你 在 终端 窗口 中 执 
行 一 些 退出 操作 ， 比 如 Ctrl+HC。 但 是 在 1s .js 脚本 里 并 不 能 创建 一 个 长 时 间 运 行 的 事件 监听 器 ， 
所 以 当 执行 到 脚本 末尾 的 时 候 ，Node 进 程 就 会 退出 。 














2.5 安装 npm 一 一 Node 包 管 理 器 


Node 本 刁 是 一 个 非常 基础 的 系统 ,只 是 包含 了 一 个 JavaScript 解 释 器 和 一 些 有 趣 的 异步 IO 库 。 
第 三 方 Node 模 块 的 生态 系统 迅速 发 展 是 Node 引 人 注意 的 原因 之 一 ， 而 整个 生态 系统 的 中 心 就 是 
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npm。 这 些 模块 可 以 以 源 代码 的 形式 下 载 并 手工 添加 用 到 Node 程 序 中 ， 而 npm 提 供 了 一 个 更 简单 
的 方式 。npm 是 一 个 非 官方 标准 的 Node 包 管理 器 ， 它 极 大 地 简化 了 下 载 和 使 用 Node 模 块 的 流程 。 
我 们 会 在 下 一 章 详 细 介绍 npm。 

输入 npmjs.org 主 页 上 展示 的 如 下 命令 来 安装 npm: 

$ curl http://npmjs.org/install.sh | sh 

这 个 命令 会 在 你 的 系统 中 下 载 并 执行 一 个 shell 脚 本 , 或 许 你 需要 在 执行 之 前 先 考虑 用 下 面 的 
命令 检查 系统 和 这 一 shell 脚 本 的 兼容 性 。 

$ curl http://npmjs.org/install.sh | less 

这 个 命令 会 安装 npm 脚 本 和 包 到 Node 所 安装 的 源 文件 中 。 这 意味 着 你 需要 注意 两 个 地 方 来 保 
证 安装 的 正确 性 。 

如 果 需 要 通过 修改 PATH 环境 变量 运行 Node， 你 可 以 通过 下 面 的 方式 在 运行 npm 安 装 程 序 时 
检查 PATH 环境 变量 的 设置 是 否 正确 : 


$ export PATH=/path/to/node/0.n.y/bin:s${PATH} 
$ curl http://npmjs.org/install.sh | sh 


下 一 个 要 考虑 的 是 假设 需要 通过 sudo make instal1 命 令 将 Node 安 装 在 系统 级 目录 。 那 么 ， 
npm 的 安装 需要 这 样 完 成 : 


$ curl http://npmjs.org/install.sh | sudo sh 


使 用 suao sh 意味 着 安装 npm 的 进程 ( /bin/sh ) 是 运行 在 root 权 限 下 的 。 
现在 npm 已 经 安装 完成 ， 让 我 们 尝试 使 用 一 下 : 


$ npm install -g hexy 

/home/david/node/0.4.7/bin/hexy -> 
/home/david/node/0.4.7/lib/node modules/hexy/bin/hexy_ cmd.js 
hexy@0.2.1 /home/david/node/0.4.7/lib/node modules/hexy 
$ hexy --width 12 ls.js 

00000000: 7661 7220 6673 203d 2072 6571 var.fs.=.req 
0000000c: 7569 7265 2827 6673 2729 3b0a uire('fs');. 
00000018: 7661 7220 6669 6c65 7320 3d20 var.files.=. 
00000024: 6673 2e72 6561 6464 6972 5379 fs.readdirsy 
00000030: 6e63 2827 2e27 293b 0a66 6f72 nc('.');.for 
0000003c: 2028 666e 2069 6e20 6669 6c65 .(fn.in.file 
00000048: 7329 207b 0a20 2063 6f6e 736f s).{...conso 
00000054: 6c65 2e6c 6f67 2866 696c 6573 le.log(files 
00000060: 5b66 6e5d 293b 0a7d 0a [fn] );.}. 


再 说 明 一 下 ， 我 们 会 在 下 一 章 深入 探讨 npm。hexy 既 是 一 个 Node 库 ， 也 是 一 个 用 于 输出 十 
六 进 制 数 据 的 脚本 。 


2.6 系统 启动 时 自动 启动 Node 服务 器 
之 前 我 们 用 命令 行 工具 启动 了 Node 服 务 器 。 虽然 这 对 测试 和 开发 有 帮助 , 但 是 对 平时 部 署 应 
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用 毫 无 用 处 。 启 动 服务 进程 的 方式 有 很 多 , 具体 因 操 作 系统 不 同 而 异 。 实 现 一 个 Node 服 务 器 意味 

着 这 个 服务 器 会 和 其 他 后 台 进 程 (sshd、apache 、mysql 等 ) 一 样 使 用 ， 例 如 启动 /停止 脚本 。 

Node 项 目 没 有 为 任何 操作 系统 提供 启动 /停止 脚本 。 也 许 有 人 会 说 ， 如 果 Node 包 含 了 这 两 个 
脚本 , 它 就 做 了 一 个 平台 不 该 涉及 的 事 。 但 是 对 于 Node 服 务 器 应 用 来 说 , 它们 需要 有 这 样 的 脚本 。 
传统 的 方式 是 使 用 init 守 护 进 程 管理 后 台 进 程 ， 这 是 通过 调用 /etc/init.d 目 录 下 的 脚本 实现 的 。 
Fedora 和 Redhat 还 是 使 用 了 这 个 进程 ， 但 其 他 操作 系统 使 用 了 其 他 守护 进程 管理 器 ， 比 如 Upstart 
或 者 launchd。 
编写 的 这 些 启动 /停止 脚本 只 是 服务 器 必需 的 一 部 分 。Web 服 务 器 需要 做 到 可 靠 ( 例如 在 崩溃 
时 能 够 做 到 自动 重启 ) 、 易 于 管理 ( 和 系统 管理 实践 结合 得 很 好 ) 、 直 观 (将 STDOUT 输 出 内 容 
保存 到 记录 文件 中 ) 等 。Node 更 像 是 一 个 建筑 工具 箱 , 包含 了 构建 服务 器 的 各 个 “零件 ”, 本 身 
并 不 是 一 个 完整 而 优美 的 服务 器 。 基 于 Node 实 现 一 个 完整 的 Web 服 务 器 意味 着 你 需要 综合 操作 系 
统 本 身 的 后 台 进 程 管理 服务 ,实现 需要 的 记录 功能 , 实施 安全 措施 或 者 防御 措施 来 对 抗 不 良 行为 ， 
比如 阻 断 来 自 外 网 的 服务 攻击 等 。 

这 里 有 一 些 工 具 或 者 措施 , 用 于 结合 Node 服 务 器 与 各 个 操作 系统 的 后 台 进 程 管 理 器 , 保证 在 
系统 启动 后 服务 器 能 可 持续 运行 。 我 们 马上 就 会 实现 一 些 简 单 的 策略 让 服务 器 能 长 久 运 行 在 
Debian 服 务 器 上 。 下 面 是 一 些 在 不 同 的 平台 上 将 Node 作 为 后 台 守 护 进程 执行 的 方式 。 

口 nodejs-autorestart ( https://github.com/shimondoodkin/modejs-autorestart ) 通过 Upstart 

( Ubuntu、Debian 等 系统 上 ) 管理 Linux 上 的 Node 实 例 。 

口 fugue (https://github.com/pgte/fugue ) 会 监听 一 个 Node 服 务 器 ， 在 其 衣 溃 的 时 候 重启 它 。 

口 forever ( https://github.com/indexzero/forever ) 是 一 个 小 型 的 命令 行 Node 脚 本 ， 用 于 确保 一 
个 脚本 能 持续 运行 。Charlie Robbins 写 了 一 篇 博文 讲解 了 它 的 使 用 ( http://blog.nodejitsu. 
com/ keep-a-nodejs-server-up-with-forever ) 。 

口 Node-init ( https://github.com/frodwith/mode-init ) 是 一 个 Node 脚 本 ， 它 可 以 将 Node 应 用 转 

换 成 符合 LSB 的 启动 脚本 。LSB 是 Linux 兼 容 性 的 规范 之 一 。 

口 Debian 系 统 上 的 launchtool ( http://people.debian.org/~enrico/launchtool. html ) 是 一 个 系统 级 

命令 ， 用 于 监听 任 一 命令 的 启动 ,包括 将 其 作为 一 个 守护 进程 运行 。 

口 Ubuntu 上 的 Upstart 工 具 (http://upstart.ubuntu.com/ ) 可 以 单独 使 用 ( http://caolanmcmahon. 
comy/posts/deploying node js_with_ upstart ) 或 者 和 monit ( http://howtonode.org/deploying- 
node-upstart-monit ) 一 起 使 用 来 管理 Node 服 务 器 。 

口 在 Mac OSX 上 ,有 人 写 了 一 个 launchd 脚 本 ,苹果 已 经 在 http://developer.apple.com/library/ 
mac/documentation/MacOSX/Conceptual/BPSystemStartup/Articles/LaunchOnDemandDaemo 
ns.html 上 发 布 了 一 个 实现 launcho 脚 本 的 说 明 。 

实践 是 检验 真理 的 唯一 标准 ， 接 下 来 我 们 尝试 使 用 forever 工 具 ， 并 结合 一 个 LSB 标 准 的 启动 
脚本 实现 一 个 小 型 的 Node 服 务 器 进程 。 服 务 器 搭建 在 基于 VPS 技 术 的 Debian 系 统 上 ,Node 和 npm 
安装 在 /usr/local/node/0.4.8 目 录 上 。 下面 的 服务 器 脚本 位 于 /usr/local/app.js ( 这 个 不 是 最 佳 的 位 置 ， 
但 是 对 这 个 示例 有 些 用 处 ) 。 
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#!/usr/bin/env node 

Var http = require('http'); 

http.createServer (function (req, res) { 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end('Hello World\n'); 

}) .listen(1337); 


仔细 注意 脚本 的 第 一 行 。 这 是 Unix/POSIX 系 统 中 的 一 个 小 窍门 ， 可 以 让 脚本 变 得 可 执行 。 
forever 工 具 是 按照 下 述 方式 安装 的 : 


$ sudo npm install -g forever 


forever 可 以 管理 后 台 进 程 。 它 可 以 在 进程 月 演 的 时 候 重 启 进程 , 传递 标准 输出 和 错误 流 到 记 
录 文 件 ， 并 且 有 其 他 一 些 实用 的 特性 。 这 个 工具 值得 探究 。 
最 后 一 步 是 设置 /etc/init.dnode 脚 本 ， 它 是 从 另 一 个 /etc/init.d 脚本 修改 而 来 : 


#! /bin/sh -e 
set -e 
PATH=/usr/local/node/0.4.8/bin:/bin:/usr/bin:/sbin:/usr/sbin 
DAEMON=/usr/local/app.js 
ase SL" Tn 
start) forever start SDAEMON ;; 
stop) forever stop S$DAEMON ;; 
force-reload|restart) 
forever restart SDAEMON ;; 
*) echo "Usage: /etc/init.d/node {start|stop|lrestart|force-reload}" 
exit 1 












































2 
esac 
exit 0 


在 Debian 系 统 中 ， 你 可 以 用 下 面 的 命令 设置 一 个 init 脚 本 : 
$ sudo /usr/sbin/update-rc.d node defaults 


这 名 命令 会 配置 你 的 系统 , 从 而 让 /etc/init.d/node 脚 本 可 以 在 系统 重启 和 关闭 时 启动 和 停止 后 
台 进 程 。 每 一 次 系统 启动 或 者 关闭 的 时 候 ， 每 个 init 脚 本 都 会 执行 ， 第 一 个 参数 是 start 或 者 
stop。 因 此 ， 当 init 脚 本 在 系统 启动 或 关闭 过 程 中 执行 时 ， 下 面 两 行 代码 之 一 就 会 执行 。 


start) forever start SDAEMON ;; 
stop) forever stop S$DAEMON ;; 


我 们 可 以 手动 执行 init 脚 本 : 


$ sudo /etc/init.d/node start 
info: Running action: start 
info: Forever processing file: /usr/local/app.js 


因为 init 脚 本 使 用 了 forever 工 具 ， 我 们 可 以 从 forever 中 获取 所 有 由 它 启动 的 进程 的 状态 。 


$ sudo forever list 
info: Running action: list 
info: Forever processes running 
[0] node /usr/local/app.js [16666, 16664] /home/me/.forever/7rd6.10g 0:0:1:24.817 
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当 服 务 器 进程 在 服务 器 上 运行 时 ， 你 可 以 打开 浏览 器 进行 访问 ， 如 下 图 所 示 。 





http://h3.7gen.com:1337!/ 
也 | ~ + | 从 http://h3.7gen.com:1337/ © | [【Qr Google » 
http://h3.7gen.com:1337/ + 


Hello World 

















因为 服务 器 处 于 执行 状态 并 由 forever 管 理 ， 所 以 我 们 可 以 直接 查看 下 面 这 些 进程 : 


$ ps ax | grep node 
16664 ? Ssl1 0:00 node /usr/local/node/0.4.8/bin/forever start /usr/local/app.js 
16666 ? S 0:00 node /usr/local/app.js 


， 你 可 以 按照 下 面 的 方式 关闭 脚本 : 


$ sudo /etc/init.d/node stop 
info: Running action: stop 
info: Forever processing file: /usr/local/app.js 
info: Forever stopped process: 
[0] node /usr/local/app.js [5712, 5711] /home/me/.forever/Gtex.1log 0:0:0:28.777 
$ sudo forever list 
info: Running action: list 
info: No forever processes running 





如 何在 多 核 系统 中 调用 所 有 CPU 


os tg 对 于 Chrome 浏 览 右 来 说 ， 这 样 已 经 足够 了 ,但 是 如 果 服 
务 右 是 基于 Node 开 发 的 , 我 们 就 只 能 使 用 一 个 新 的 16 核 服务 器 中 的 一 个 CPU, 其 他 15 个 CPU 却 闲 
置 在 一 边 。 你 的 上 司 或 许 会 se ee eg 

一 个 单线 程 进程 只 能 使 用 一 个 CPU。 这 就 是 事实 。 在 一 个 线程 中 使 用 多 核 需 要 支持 多 线程 的 
软件 。 但 是 Node 是 “没有 线程 概念 ”的 平台 ,虽然 这 让 编程 变 得 简单 ， 但 是 也 意味 着 Node 不 能 
将 多 核 系统 利用 起 来 。 该 怎么 做 呢 ? 或 者 更 重要 的 是 ， 如 何 取 悦 你 的 上 司 ? 
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现在 有 很 多 项 目 在 努力 定制 足够 可 靠 的 多 线程 Node, 同 时 希望 将 多 核 系统 的 硬件 性 能 都 发 挥 
出 来 。 

最 基础 的 想法 就 是 启动 多 个 Node 进 程 , 在 进程 之 间 共 享 请 求 通信 和 量 。 使 用 多 个 单线 程 进程 可 
以 充分 利用 所 有 的 CPU， 并 让 你 的 上 司 觉得 服务 器 的 投入 是 值得 的 。 

Cluster ( https://github.com/ LearnBoost/cluster ) 是 多 线程 Node 服 务 器 项 目 中 的 一 个 ， 它 被 称 
为 “为 Nodejs 设 计 的 、 可 扩展 的 多 核 服 务 需 管理 需 ”。 它 会 启动 一 系列 可 配置 的 子 进程 ， 在 进程 
骨 溃 的 时 候 重 启 它 们 ， 并 拥有 可 扩展 的 记录 功能 ， 命 令 控制 模块 和 统计 功能 。 老 的 Spark 项 目 已 
停止 ， 人 们 开始 转投 Cluster 项 目 。 

Cluster 项 目 包 括 了 几 个 服务 器 配置 示例 ， 展 示 了 它 的 作用 。 让 我 们 安装 Cluster 并 使 用 一 个 例 
子 看 看 它 的 工作 原理 : 


$ sudo npm install cluster 
cluster@0.6.4 ./node modules/cluster 
[一 一 1oge1.2.0 


我 们 要 使 用 的 例子 (reloada.js ) 是 其 中 的 一 个 典型 ， 我 们 对 app .js 进行 修改 并 创建 
cluster-app.js, 其 中 包含 下 面 的 代码 : 


#!/usr/bin/env node 

Var http = require('http'); 

Var cluster = require('cluster'); 

Var server = http.createServer (function (req, res) { 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end('Hello World\n'); 

} 

cluster(server) .Set ('workers', 2) .use(cluster.reload()) 
.listen(1337); 


Cluster 配 置 创建 了 两 个 工作 者 进程 并 用 于 共享 负荷 ， 它 会 自动 重新 加 载 已 修改 的 文件 。 你 可 
以 阅读 Cluster 项 目 站 点 上 的 文档 了 解 更 多 内 容 。 

它 可 以 通过 node cluster-app.js 命 令 运行 ， 不 过 我 们 要 通过 修改 /etc/init.d/node 来 运行 这 
个 脚本 。 我 们 只 需要 设置 DAEMON 变 量 为 如 下 的 值 : 

DAEMON=/usr/local/cluster-app.js 

然后 : 


$ sudo /etc/init.d/node start 
info: Running action: start 
info: Forever processing file: /usr/local/cluster-app.js 
$ sudo forever list 
info: Running action: list 
info: Forever processes running 
[0] node /usr/local/cluster-app.js [6522, 6521] 
$ ps ax | grep node 
6521 ? Ssl1 0:00 node /usr/local/node/0.4.8/bin/forever start 
/usr/local/cluster-app.js 
6522 ? S1 0:15 node /usr/local/cluster-app.js 
6541 ? 5S 0:00 /usr/local/node/0.4.8/bin/node /usr/local/cluster-app.js 
6542 ? S 0:00 /usr/local/node/0.4.8/bin/node /usr/local/cluster-app.js 
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现在 你 可 以 看 到 一 个 多 进程 的 Node 服 务 器 正在 运行 。 我 们 可 以 用 ps 命令 查看 两 个 进程 ， 也 
可 以 通过 浏览 需 访 问 http:/example.com:1337/ 来 进行 验证 服务 需 是 否 正 在 运行 〈 服务 顺 运 行 时 会 
看 到 “Hello World” 消 息 ) 。 但 是 因为 它 使 用 了 Cluster 的 自动 重新 加 载 特性 ， 你 可 以 对 
cluster-app.js 做 一 些 适 当 的 修改 ,使 得 刷新 浏览 器 〈 不 需要 重启 服务 器 ) 时 可 以 看 到 如 下 图 
所 示 的 内 容 。 











http://h3.7gen.com:1337!/ 
4 | | 十 | 加 http://h3.7gen.com:1337/ © | (Qr Google » 
http:/ /h3.7gen.com:1337/ + 


Hello Modified World 











2.7 ”小结 


我 们 在 这 一 章 学 习 了 Node 的 安装 、 命 令 行 工 具 的 使 用 和 如 何 运 行 一 个 Node 服 务 器 。 我 们 也 
介绍 了 一 些 之 后 几 章 会 详细 介绍 的 内 容 。 

本 章 具体 内 容 包 括 : 
口 下 载 并 编译 Node 源 代码 ; 
口 安装 Node 的 方法 , 分 别针 对 个 人 开发 的 用 户 目录 安装 方式 和 针对 部 署 的 系统 级 安装 方式 ; 
口 安装 非 官 方 的 Node 包 管理 器 npm; 
口 运行 Node 脚 本 和 Node 服 务 需 ; 
口 如 何 更 安全 地 用 Node 启 动 后 台 进 程 ; 
口 如 何 用 Node 实 现 多 进程 ， 以 利用 所 有 CPU。 

现在 我 们 已 经 了 解 如 何 配置 基本 的 系统 , 接 下 来 可 以 用 Node 开 发 应 用 了 。 首先 我 们 会 学 习 以 
模块 为 单位 的 Node 应 用 构建 方式 ， 这 是 下 一 章 的 主要 内 容 。 





























Node 模 块 








开始 编写 Node 应 用 之 前 ， 必 须 先 学 习 Node 的 模块 和 包 。 模 块 和 包 是 组 成 应 用 的 基本 单位 。 


本 章 内 容 

口 什么 是 模块 ; 

口 CommonJS 模 块 规范 ; 
口 Node 搜 索 模 块 的 方式 ; 
口 npm 包 管理 系统 。 


开始 吧 。 


3.1 什么 是 模块 


模块 是 构成 Node 应 用 的 组 件 。 实 际 上 我 们 已 经 看 到 过 一 些 模块 了 一 一 我 们 在 Node 中 使 用 的 
每 一 个 JavaScript 文 件 都 是 一 个 模块 。 接 下 来 让 我 们 看 看 这 些 模 块 是 什么 ， 它 们 是 怎么 工作 的 。 

在 第 2 章 的 1s .js 例子 里 ， 我 们 写 了 如 下 的 代码 来 引入 fs 模块 ， 从 而 可 以 访问 fs 模块 内 部 的 
函数 : 

var fs = require('fs'); 

recuire 国 数 会 搜索 模块 , 然后 将 模块 的 定义 载 和 Node 的 执行 环境 , 从 而 让 对 应 的 函数 可 以 
供 外 部 调用 。 这 个 例子 里 的 fs 对 象 包含 从 fs 模块 里 导出 的 代码 和 数据 。 

在 进行 详细 介绍 前 ， 让 我 们 先 看 一 个 简单 的 例子 。 思 考 一 下 模块 simple .js: 


Var COUunt "0 
exports.next = function() { return count++; } 


这 个 模块 定义 了 一 个 对 外 开放 的 函数 和 一 个 局 部 变量 。 使 用 方法 如 下 图 所 示 。 

从 require('./simple') 返 回 的 这 个 对 象 正 是 我 们 在 simple.js 里 定义 的 exports。 每 
一 次 对 s .next 的 调用 都 是 对 simple.js 里 next 函 数 的 调用 ， 然 后 next 函 数 返 回 (已 自 增 的 ) 
count 变 量 值 ， 这 样 也 就 解释 了 为 什么 s next 方 法 返回 的 值 越 来 越 大 。 

require 的 机 制 就 是 exports 的 所 有 成 员 (包括 函数 、 对 象 ) 都 会 被 暴露 给 模块 外 部 的 代码 ， 
而 那些 没有 指定 在 exports 下 的 对 象 ， 在 模块 外 部 是 不 可 见 的 。 这 就 是 一 个 模块 封装 的 例子 。 
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Terminal 一 bash 一 71x17 
$ node 四 
> Yar s = requiref ' .simple 
> S.Nextt)s; 
a 
> Snext( 7); 
生 
> Snext( 7); 
> s.nextO); 


>$ 











我 们 已 经 简单 了 解 模块 的 封装 ， 接 下 来 进行 更 深入 的 了 解 。 
3.1.1 Node 模块 


Node 的 模块 实现 深 受 CommonJS 模 块 规范 ( 会 在 本 音 最 后 做 介绍 ) 的 影响 , 但 并 不 与 之 相同 。 
只 有 当 你 想 要 在 Node 和 其 他 CommonJS 系 统 之 间 共 享 代 码 时 ， 它 们 之 间 的 区 别 才 会 显得 比较 重 
要 。 只 要 快速 浏览 一 下 Modules/1.1.1 规 范 就 能 知道 ， 两 者 之 间 的 差别 并 不 重要 ， 而 且 就 我 们 的 目 
的 而 言 ， 只 要 学 习 怎 样 使 用 Node 就 够 了 ， 不 用 在 两 者 的 差异 上 想 太 多 。 








3.1.2 Node 解析 require('module' ) 的 方式 


在 Node 里 , 模块 存储 在 文件 中 , 每 个 文件 仅 存 储 一 个 模块 。 在 文件 系统 中 有 几 种 方法 命名 和 
部 署 模块 ， 这 些 方 法 灵活 多 样 ， 尤 其 是 使 用 非 官方 的 Node 包 管理 器 npm 时 。 

1. 模块 标识 符 与 路 径 名 

一 般 来 说 ,模块 名 就 是 一 个 没有 文件 后 级 的 路 径 名 。 也 就 是 说 ， 当 我 们 写 下 requir 
('./simple') 时 ，Node 会 自动 把 .js 加 到 文件 名 后 并 加 载 simple .js。 

那些 以 “.js” 为 后 级 名 的 文件 对 应 的 模块 自然 应 该 以 JavaScript 编 写 。Node 也 支持 二 进 制 原 
生 语 言 库 ， 并 将 它们 用 作 Node 模 块 。 这 样 的 情况 下 ， 文 件 名 后 缀 就 是 .node。 不 过 ， 我 们 不 会 探 
讨 如 何 实 现 原 生 语 言 的 Node 模 块 ， 但 当 你 遇 到 这 些 模块 时 这 些 内 容 足 以 让 你 理解 和 辨别 它们 。 

一 些 Node 模 块 并 不 以 文件 形式 存储 在 操作 系统 的 文件 系统 中 ， 而 是 会 被 编译 成 Node 可 执行 
文件 ， 这 些 模块 是 核心 模块 ，nodejs.org 官 方 文档 已 经 列 出 。 它 们 原本 在 Node 源 代码 中 以 文件 形 
式 存在 ， 但 是 构建 进程 将 其 编译 成 了 二 进 制 Node 可 执行 文件 。 

Node 里 有 3 种 定义 模块 的 方式 : 相对 路 径 的 定义 方式 、 绝 对 路 径 的 定义 方式 和 顶级 目录 的 定 
义 方 式 。 

用 相对 路 径 定义 的 模块 的 标识 符 以 “. 7/ ”或 者 “. .7/” 开 头 ， 用 绝对 路 径 定 义 的 模块 的 标识 



















































































@ 现在 npm 已 经 被 集成 到 node 安 装 包 里 了 。 
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符 以 “/” 开 头 。 这 与 POSIX 文 件 系统 中 通过 文件 路 径 执行 可 执行 文件 的 语法 是 一 致 的 。 

很 明显 ， 绝 对 路 径 定义 的 模块 标识 符 与 文件 系统 的 根 目录 相关 。 

顶级 目录 的 模块 标识 符 不 是 以 “.”、“..” 或 “/” 开 头 ， 而 是 以 模块 名 开头 。 这 些 模块 储 
存 于 某 个 目录 中 ， 比 如 node_modules 目 录 , 或 者 其 他 被 列 在 require.paths "数组 (Node 将 之 
用 于 指定 存储 这 些 模块 的 目录 ) 里 的 目录 中 。 这 些 内 容 会 在 之 后 讨论 到 。 

2. Node 应 用 里 的 本 地 模块 

所 有 模块 被 整齐 地 划分 为 两 类 ， 一 类 是 特定 应 用 的 模块 ， 另 一 类 就 是 非特 定 应 用 的 模块 。 但 
愿 非特 定 应 用 的 模块 会 被 写成 通用 模块 。 我 们 现在 开始 介绍 如 何 实现 应 用 要 使 用 的 模块 。 

应 用 通常 都 会 有 一个 专属 的 目录 结构 ,遵从 这 一 目录 结构 的 模块 文件 按 序 放置 在 源 代码 控制 
系统 中 ， 然 后 会 被 部 署 到 服务 器 上 。 这 些 模块 能 够 获取 该 应 用 内 其 他 模块 的 相对 路 径 ， 并 能 通过 
相对 路 径 标识 符 互相 访问 。 

举 个 例子 ， 为 方便 理解 ， 让 我 们 看 下 一 个 已 经 构建 好 的 Express 应 用 框架 的 Node 包 目录 。 它 
包括 了 以 多 级 目录 形式 存放 的 模块 , Express 开 发 者 比较 喜欢 这 样 的 组 织 方式 。 你 可 以 想象 下 为 应 
用 创建 一 个 达到 一 定 复杂 程度 的 层级 ， 将 应 用 分 解 成 一 个 个 比 模块 大 但 比 应 用 小 的 数据 块 的 情 
形 。 遗憾 的 是 在 Node 里 没有 词 可 以 形容 它 ， 所 以 我 们 只 能 用 诸如 “分 解 为 比 模块 大 的 数据 块 ”之 = 
类 的 笨拙 语句 来 形容 。 每 个 被 分 解 出 来 的 数据 块 都 可 以 作为 含有 多 个 模块 的 目录 来 实现 。 





























™ express 
> bin 
_ | History.md 
js index.js 
vi lib 
js| express.js 
js http.js 
js https.js 
js| request.js 
js response.js 
™ 国 router 
js collection.js 
ji index.js 
js methods.js 
js route.js 
js utils.js 
| view 
js partial.js 
js| view.js 
js vicw.js 
| LICENSE 
_ Makefile 
™ BN node_modules 
> qs 
| package.json 
| Readme.md 


本 














@ 现在 require.paths 已 经 被 移 除 了 。 
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在 这 个 例子 里 ， 我 们 最 有 可 能 引用 模块 utils .js。 我 们 可 以 使 用 如 下 的 require 语 句 之 一 
使 用 utils .js: 


Var utils = require('./lib/utils'); 
Var utils = require('./utils'); 


var utils require('../utils'); 


3. 绑 定 应 用 的 外 部 依赖 

引用 node_modules 目 录 中 的 模块 必须 使 用 顶级 目录 标识 符 : 

Var express = require('express'); 

Node 会 在 寻找 模块 时 搜索 node_modules 目 录 。Node 里 含有 不 止 一 个 以 供 搜索 的 node_mogdules 
目录 。Node 会 从 当前 模块 的 目录 开始 ， 先 把 node_modules 目 录 添 加 进去 , 然后 搜索 当前 日 录 下 
的 node_modules。 如 果 在 当前 node_modules 目 录 下 没有 找到 对 应 的 模块 ，Node 会 转向 父 级 目 
录 并 再 次 进行 搜索 ， 以 此 类 推 ， 直 到 到 达 文 件 系 统 的 根 目 录 。 

在 前 面 的 例子 里 , 注意 node_modules 文 件 夹 中 有 一 个 名 为 qs 的 目录 。 在 这 个 目录 位 置 , 若 
执行 下 面 的 代码 ，Express 里 的 所 有 模块 都 可 以 访问 qs 模块 。 

Var qs = require('gs'); 

如 果 你 想 要 在 应 用 中 使 用 Express 框 架 ， 该 怎么 办 ? 很 简单 ， 在 你 的 应 用 目录 里 创建 一 个 

node_moqules 目 录 ， 然 后 把 Express 框 架 安装 到 那里 ， 如 下 图 所 示 。 

















Y a projects 
Y BB drawapp 
中 index.js 
vi lib 
jsl draw.js 
pb [9 node_modules 
js svg.js 
™ BB node_modules 
™ BY express 
> 全 bin 
History.md 
器 index.js 
> Ilib 
|] LICENSE 
Makefile 
™ BB node_modules 
> 的 qs 
| package.json 
| Readme.md 
package.json 
™ BB node_modules 
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如 上 图 所 示 , 假设 有 一 个 应 用 drawapp。 因 为 node_modules 人 处 于 drawapp 中 的 一 个 子 目 录 
下 ， 所 以 所 有 在 arawapp 里 的 模块 都 可 以 用 下 面 的 代码 访问 express。 

var express = require('express'); 

但 是 这 些 模块 无 法 访问 存放 在 express 模 块 内 的 qs 模块 。 在 文件 系统 中 , 对 node_modules 
目录 的 搜索 是 往 父 级 〈 逐 级 ) 查找 ， 而 不 是 查找 子 目 录 。 

同样 ， 一 个 安装 在 1ib/node_mogdules 目 录 下 的 模块 也 可 以 被 draw .js 或 者 svg .js 访问 ， 
但 是 不 能 被 index .js 访问 ,对 node_modules 目 录 的 搜索 都 是 逐 层 往 上 而 不 是 逐 层 往 下 进行 的 。 

Node 会 逐 层 向 上 搜索 node_modqules 目 录 ， 然 后 在 第 一 次 找到 需要 的 模块 后 停止 在 所 在 目 
录 。draw.js 或 者 svg .js 内 部 的 一 个 模块 引用 会 搜索 如 下 的 目录 : 
口 /home/david/projects/drawapp/lib/node modules 


























口 /home/david/projects/drawapp/node modules 
口 /home/david/projects/node modules 
口 /home/david/node modules 


口 /home/node modules 





口 node modules 

在 维护 多 个 版 本 冲突 的 Node 包 时 , noaqe_modqules 目 录 起 着 关键 作用 。 比 起 只 用 一 个 地 方 存 
放 模 块 ， 然 后 因 多 个 版 本 的 模块 冲突 抓 狂 ， 更 好 的 方式 就 是 提供 多 个 node_modqules 目 录 ， 以 便 
必要 时 在 特定 的 位 置 存放 特定 版 本 的 模块 。 若 将 不 同 版 本 的 同一 模块 放 在 不 同 的 nodqe_modqules 
目录 下 ， 只 要 nodqe_modqules 目 录 位 置 正确 ， 模 块 间 就 不 会 相互 冲突 。 

比如 , 如 果 写 了 一 个 使 用 forms 模 块 (https:/ github.com/caolan/forms ) 辅助 创建 表单 的 应 用 ， 
在 你 写 了 几 百 个 不 同 的 表单 之 后 ，forms 模 块 的 作者 对 模块 进行 了 一 些 修改 ， 而 这 些 修改 可 能 使 
模块 与 你 的 应 用 不 兼容 。 面 对 这 么 多 需要 转换 和 测试 的 表单 , 你 可 能 不 会 想 一 下 子 完成 这 一 工作 。 
那么 , 这 样 的 情况 下 , 你 就 需要 为 应 用 建 两 个 目录 , 每 一 个 目录 都 需要 有 属于 自己 的 node_ modules 
文件 夹 ， 文 件 夹 里 对 应 存放 不 同 版 本 的 forms 模 块 。 当 成 功 将 一 个 表单 转换 到 新 forms 模 块 时 ， 
你 就 可 以 将 那些 代码 转移 到 新 forms 模 块 的 文件 夹 下 。 

4. require.paths 目 录 下 的 系统 级 模块 

Node 用 来 查找 node_modules 目 录 的 算法 会 搜索 应 用 源 代码 树 之 外 的 模块 。 它 会 一 直 搜 索 ， 
直到 文件 系统 的 根 目录 下 ， 所 以 你 最 好 能 有 一 个 包含 全 局 模块 的 node_modules 目 录 ， 以 满足 
Node 对 模块 的 任意 搜索 。 

Node 还 通过 require.paths 变 量 提供 了 一 项 功能 。 它 是 一 个 由 目录 名 构成 的 数组 ， 我 们 可 
以 在 这 个 数组 里 搜索 模块 。 

具体 的 例子 如 下 : 


$ node 
> require.paths; 
["/home/david/.node modules","/home/david/.node libraries","/usr/local/lib/node"] 


NODE_PATH 环 境 变 量 也 可 以 添加 目录 到 require.paths 数 组 中 : 
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export NODE PATH=/usr/lib/node 

node 

require.paths; 

"/usr/lib/node","/home/david/.node libraries","/usr/local/lib/node"] 


$ 
$ 
[ 
曾几何时 ， 人 们 习惯 于 按照 下 面 这 种 方法 给 require.paths 添 加 目录 : require.paths . 
push(_dirname) 。 不 过 , 现在 这 已 经 不 是 推荐 的 方式 , 因为 实践 证 明 这 个 方法 会 导致 一 些 麻 烦 。 
虽然, 现在 你 依然 可 以 使 用 这 样 的 方法 , 而且 依然 存在 使 用 这 个 习惯 构建 的 模块 , 但 我 们 绝 不 赞 
成 这 么 做 。 当 将 多 个 模块 的 目录 放 进 require .paths 时 ， 结果 会 变 得 不 可 预知 。 

大 部 分 情况 下 ， 最 住 实践 就 是 将 模块 放 到 nogde_modules 目 录 里 。 

5. 复杂 的 模块 一 一 作为 目录 的 模块 

一 个 复杂 的 模块 可 能 包括 了 许多 内 部 模块 、 数 据 文件 、 模 版 文件 、 文 档 、 测 试 文件 等 。 这 些 
内 容 可 以 存放 在 一 个 仔细 构建 的 目录 结构 里 ， 由 Node 将 其 视 作 一 个 模块 ， 可 以 满足 一 个 
reauire('modquleName ') 这 样 的 请 求 的 处 理 需 要 。 为 此 ， 你 先 得 把 indaex. js 模块 文件 或 者 
package.json 文 件 放 到 一 个 目录 里 。package.json 文 件 里 包含 描述 模块 的 数据 ， 其 数据 格式 
和 npm 定 义 的 package.json 格 式 基 本 一 致 ( 稍 后 介绍 )。 这 两 者 都 使 用 了 npm 能 识别 的 非常 小 的 
标签 子 集 ， 从 而 做 到 了 与 Node 兼 容 。 

具体 而 言 ，Node 可 以 识别 package.json 里 这 样 类 型 的 字段 ; 

{ name: "myAwesomeLibrary", 

main: "./lib/awesome.js" } 

有 了 package.json 之 后 ，require('myAwesomeLibrary') 代 码 就 可 以 找到 这 个 目录 并 
加 载 对 应 的 文件 : 

/path/to/node modules/myAwesomeLibrary/lib/awesome.js 

如 果 没 有 package .json 文 件 ，Node 会 查找 index.js， 从 而 加 载 文 件 : 

/path/to/node_ modules/myAwesomeLibrary/index.js 

无 论 选择 了 index.js 还 是 package .json， 含有 内 部 模块 和 其 他 资源 的 复杂 模块 都 是 比较 
容易 实现 的 。 回头 来 看 我 们 之 前 讨论 的 Express 包 结构 , 一 些 模块 会 使 用 模块 的 相对 路 径 标 识 符 引 
用 包 里 的 其 他 模块 ， 而 你 可 以 使 用 一 个 node_mogdule 目 录 整 合 在 其 他 地 方 开 发 的 模块 。 
































3.2 Node 包 管 理 器 


就 像 在 第 2 章 里 描述 的 ,npm 是 一 个 Node 包 管理 和 分 发 工具 。 它 已 经 成 为 了 非 官方 的 发 布 Node 
模块 ( 包 ) 的 标准 。 从 概念 上 理解 ， 它 和 apt-get ( Debian )、rpm/yum ( Redhat/Fedora )、MacPorts 
(MacOSX )、CPAN (Perl ) 或 者 PEAR (PHP ) 这 些 工 具 很 类 似 。 它 存在 的 目的 就 是 在 因特网 上 
通过 简单 的 命令 行 界 面 发 布 和 管理 Node 包 .有 了 npm, 你 就 可 以 很 快 地 找到 特定 服务 要 使 用 的 包 ， 
进行 下 载 、 安 装 以 及 管理 已 经 安装 的 包 。 

npm 为 Node 定 义 的 包 格 式 大 部 分 基于 CommonJS 包 规范 。 


























3.2.1 npm 包 的 格式 


一 个 hpm 包 是 包含 了 backage .json 的 文件 来 ，package.json 描 述 了 这 个 文件 夹 的 结构 。 
除了 npm 所 识别 的 package.json 标 签 比 Node 能 识别 的 多 得 多 ， 它 恰好 就 是 我 刚刚 说 到 的 复杂 模块 。 
CommonJS Packages/1.0 规范 是 npm 的 package.json 的 起 点 。 npm 的 package .json 文 档 可 以 通过 如 
下 方式 访问 : 

$ npm help json 


一 个 基本 的 package.json 文 件 是 这 样 的 : 


name: "packageName", 
VELSlONn: Tl. 0™. 
main: "mainModuleName", 
modules: { 
"mdl"s "LiB/modLl™, 
mad2n nl iD/mod2n 
} 
} 


这 个 文件 是 JSON 格 式 的 ， 作 为 一 名 JavaScript 程 序 员 ， 这 样 的 格式 你 应 该 已 经 很 熟悉 了 。 

最 重要 的 标签 就 是 ame 和 version。 名 称 会 出 现在 URL 还 有 命令 名 里 ， 所 以 需要 选择 一 个 
对 双方 都 可 靠 的。 如 果 想 要 在 公共 的 npm 仓 库 里 发 布 一 个 包 , 你 最 好 在 http://search.npmjs.org 上 (或 
通过 如 下 命令 ) 检查 包 名 是 否 已 被 使 用 。 

$ npm search packageName 

main 标 签 的 使 用 和 在 前 一 节 关 于 复杂 模块 的 讨论 类 似 。 当 调用 require ('packageName') 
时 ，main 指 向 的 入口 模块 会 返回 。 包 本 身 也 可 以 包含 很 多 模块 ， 这 些 模块 都 可 以 在 modules 列 
表 中 列 出 。 

Node 包 是 可 以 以 tar-gzip 格 式 打 包 的 ， 特 别 是 要 将 Node 包 通过 因特网 传输 时 。 

Node 包 可 以 声明 与 其 他 包 的 依赖 关系 。 这 样 的 话 ，npm 可 以 自动 安装 其 他 被 依赖 的 包 。 依 赖 
关系 是 这 样 定义 的 : 








~ 













































































"dependencies": 
{ "foo" ; "1.0.0 - 2.9999.9999" 
» Ba 2 Tl ,0 


} 
描述 和 关键 词 字 段 可 以 帮助 人 们 在 npm 仓 库 ( http://search.npmjs.org ) 中 寻找 Node 包 。Node 
包 的 所 有 权 信息 可 以 记录 在 主页 、 作 者 或 者 贡献 者 字段 中 : 
"description": "My wonderful packages walks dogs", 


"nomepage": "http://npm.dogs.org/dogwalker/", 
"author": dogwhisperer@dogs.org 


一 些 npm 包 通过 向 用 户 的 PATH 变 量 写 入 数据 ( 路 径 ) 提供 可 执行 程序 。 这 些 包 是 通过 bin 标 
签 声明 的 。 这 是 一 个 命令 名 到 实现 该 命令 的 脚本 的 映射 。 命 令 脚本 会 被 通过 名 称 引用 并 安装 在 包 
含 Node 可 执行 文件 的 目录 中 。 
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bin: { 
‘nodeload.js': './nodeload.js' 
?和 


}， 

qirectories 标签 用 于 记录 包 的 目录 结构 。1ib 目 录 中 的 文件 会 被 自动 扫描 并 加 载 。 现在 还 
有 其 他 特定 于 二 进 制 文件 、 指 南 和 参考 文件 这 样 的 目录 字段 。 

directories: { lib: './lib', bin: './bin' }, 

脚本 标签 是 一 个 在 Node 包 生命 周期 中 对 应 各 个 事件 执行 的 脚本 命令 。 这 些 事 件 包括 
install、activate、uninstall、update 等 。 你 可 以 用 下 面 的 命令 查看 更 多 的 脚本 命令 。 

$ npm help scripts 

以 上 内 容 只 是 关于 npm 包 格式 的 一 小 部 分 ， 欲 知 更 多 详细 资料 可 以 阅读 文档 ( npm help 


json )。 








3.2.2 查找 npm 包 


默认 情况 下 ，npm 模 块 可 从 http://npmijs.org 官 方 网 站 上 的 安装 包 登 记 处 获取 。" 如 果 你 知道 这 
个 模块 的 名 字 ， 可 以 通过 输入 下 述 命令 来 安装 : 

$ npm install moduleName 

但 是 如 果 你 不 知道 模块 的 名 字 怎 么 办 ? 如 何 才能 找到 想 要 的 模块 ? 

http:/npmjs.org 网 站 会 把 已 注册 的 模块 按照 索引 公布 出 来 ， 这 样 你 就 可 以 在 http:/search.npmjs.org 
网 站 上 按照 索引 值 找到 想 要 的 模块 。 

npm 也 提供 了 查找 模块 的 命令 行 搜索 功能 : 

$ npm search mp3 

mediatags Tools extracting for media meta-data tags =coolaj86 util m4a aac mp3 id3 


jpeg exiv xmp 
node3p An Amazon MP3 downloader for NodeUJS . =ncb000gt 


当然 ， 上 面 找到 的 模块 可 以 按照 如 下 方式 安装 : 
$ npm install mediatags 
安装 一 个 模块 后 ， 有 些 人 可 能 会 想 看 一 下 模块 对 应 站 点 上 的 文档 。package.json 文 件 里 的 


homepage 标 签 对 应 的 值 就 是 这 个 站 点 主页 的 地 址 。 查 看 package .json 文 件 最 方便 方法 就 是 如 
下 使 用 命 ie 令 npm View : 


$ npm view zombie 




















{ name: 'zombie', 
description: 'Insanely fast, full-stack, headless browser testing using Node.js', 


version: '0.9.4', 























Q( 这 里 的 言 下 之 意 应 该 是 说 可 以 自己 架设 包 服务 器 。 








homepage: 'http://zombie.labnotes.org/', 
npm ok 
你 可 以 使 用 npm view 从 package.json 里 查看 任意 一 个 标签 对 应 的 信息 ， 比 如 下 面 的 命令 
能 用 于 查看 nomepage 标 签 : 


$ npm view zombie homepage 
http://zombie.labnotes.org/ 





3.2.3 ”使 用 npm 命令 

npm 主 命令 包含 很 多 子 命令 , 子 命令 对 应 特定 的 包 管理 操作 。 这 些 命令 涉及 一 个 Node 包 生命 
周期 的 每 一 个 部 分 操作 ， 包 括 发 布 (站 在 包 作者 的 角度 )、 下 载 、 使 用 或 者 移 除 ( 站 在 一 个 npm 
使 用 者 的 角度 )。 











npm - Node Package Manager 
4|>|| 合 ||A | A | 旧 | 工 罕 | w+ 加 hep:y/npmjs.org/ © | [Qr Google 大 


npm - Node Package Manager 





npm is a package manager for node. You can use it to install 
and publish your node programs. It manages dependencies and 
does other cool stuff. 


One Line Install 
curl http://npmis.org/install.sh | sh 
More Than One Line Install 


1. Get the code. 
2. Do what the README says to do. 

















1. 获取 npm 的 帮助 

或 许 最 重要 的 事情 是 知道 去 哪里 寻求 帮助 。 最 主要 的 帮助 信息 可 以 通过 下 述 方式 获取 。 

你 可 以 按照 下 面 的 方式 查看 大 部 分 命令 的 帮助 信息 : 

$ npm help <command> 

npm 网 站 ( http://npmjs.org/ ) 有 FAQ (常见 问题 解答 )， 并 且 提 供 npm 软 件 下 载 。 或 许 和 npm 
相关 的 最 重要 问题 ( 及 答案 ) 就 是 : 为 什么 npm 不 喜欢 我 ”npm 不 懂 恨 ， 它 对 每 一 个 人 都 很 友好 ， 
包括 你 。 
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Terminal bash laclh 
$ npm help 日 


Usage: npm <Command> 


Where <=command> is one of: 
adduser, author, bin, ¢, cache, completion, config, 
deprecate, docs, edit, explore, faq, find, get, help, i, 
info, init, install, la, link, list, ll, lIn, ls, outdated, 
owner, prefix, prune, publish, r, rb, rebuild, restart, rm, 
root, run-script, s, se, search, set, start, stop, tag, 
test, un, uninstall, unlink, unpublish, up, update, version, 
Yiew, whoami 


sdd -h to any command for quick help. 











2. 查看 包 信 息 
npm view 命 令 会 把 package .json 文 件 当做 数据 ， 让 你 能 够 找到 使 用 点 标记 法 记录 的 JSON 
标签 ， 比 如 如 下 查看 包 的 依赖 关系 : 


$ npm view google-openid dependencies 
{ express: '>= 0.0.1', 
openid: '>= 0.1.1 <= 0.1.1' } 


package.json 文 件 可 以 包含 Node 包 仓库 的 地 址 (URL )。 因 此 ， 如 果 想 要 检索 包 的 源 文 件 ， 
可 以 使 用 如 下 代码 : 


$ npm view openid repository.url 
git://github.com/havard/node-openid.git 

$ git clone git://github.com/havard/node-openid.git 
Cloning into node-openid... 

remote: Counting objects: 253, done. 

remote: Compressing objects: 100% (253/253), done. 
remote: Total 253 (delta 148), reused 0 (delta 0) 
Receiving objects: 100% (253/253), 63.29 KiB, done. 
Resolving deltas: 100% (148/148), done. 


对 于 一 个 包 ， 什 么 版 本 的 Node 是 必需 的 ? 


$ npm view openid engines 
node >= 0.4.1 


3. npm 包 的 安装 
npm install 命 令 让 安装 Node 包 变 得 很 容易 : 





$ npm install openid 

openid@0.1.6 ./node modules/openid 
$ ls node modules/ 

openid 


仔细 看 你 会 发 现 Node 包 是 安装 在 本 地 的 node_modqules 目 录 下 的 。 你 也 可 以 通过 改变 当前 的 
目录 将 Node 包 安装 到 其 他 位 置 , 或 者 让 npm 执 行 一 个 全 局 安装 。 例如， 下 面 的 命令 会 建立 一 个 目 
录 /Var/www， 其 中 /Var/www/node_modules 会 存放 为 多 个 站 点 共享 的 模块 。 








$ cd /var/www 
$ npm install openid 
openid@0.1.6 ./node modules/openid 


npm 的 安装 分 为 全 局 模式 和 本 地 模式 。 一 般 情况 下 会 以 本 地 模式 运行 ， 包 会 被 安装 到 和 你 的 
应 用 代码 同 级 的 本 地 node_modules 目 录 下 。 在 全 局 模式 下 ，Node 包 会 被 安装 到 Node 的 安装 目 
录 下 (require.paths 中 的 目录 )， 而 不 是 当前 文件 夹 的 子 文件 夹 node_modules 中 。 

全 局 模式 下 安装 Node 包 的 第 一 种 方法 是 如 下 使 用 -g 标 志 : 

$ npm install -g openid 

openid@0.1.6 /usr/local/node/0.4.7/lib/node modules/openid 


$ which node 
/usr/local/node/0.4.7/bin/node 


全 局 模式 下 的 Node 包 安装 位 置 取决 于 Node 被 安装 的 位 置 。 

全 局 模式 下 的 第 二 个 安装 方法 是 修改 npm 配 置 设 置 。 配 置 设置 里 有 很 多 配置 项 ， 这 些 配 置 项 
会 在 之 后 讨论 ， 现 在 只 探讨 下 面 这 个 配置 : 

$ npm set global=true 

$ npm get global 

true 


$ npm install openid 
openid@0.1.6 /usr/local/node/0.4.7/lib/node modules/openid 


和 欲 了 解 apm 使 用 的 所 有 文件 夹 ， 请 键入 下 面 的 命令 : 

$ npm help folders 

4. 使 用 已 安装 的 Node 包 

安装 Node 包 的 意义 在 于 启用 Node 程 序 ， 通 过 下 面 的 方式 访问 模块 : 

Var openidq = require('openid'); 

np 所 做 的 就 是 帮 你 顺利 地 完成 这 些 工作 。 

有 些 Node 包 的 内 部 模块 对 其 他 软件 有 帮助 。 比 如 ， 当 前 我 们 安装 的 openia 模 块 包含 一 个 
base64 encode/decode 模 块 ， 其 他 软件 也 可 以 引用 这 个 模块 :; 

Var base64 = require('openid/lib/base64') .base64; 

但 是 ，openia 模 块 可 能 会 对 它 的 base64 encode/decode 模 块 做 一 些 改动 ， 日 这 样 会 影响 
到 你 的 应 用 。 一些 Node 包 对 结构 进行 了 调整 ,从 而 可 以 提供 一 组 相关 的 、 可 用 上 述 方式 引用 的 子 
模块 ， 并 向 外 部 的 模块 提供 特定 于 这 些 子 模块 的 、 稳 定 的 API。 

5. 查看 已 安装 的 Node 包 

npm 1ist 命 令 可 以 列 出 已 经 安装 的 包 ， 它 会 对 当前 的 目录 进行 一 次 搜索 。 记 住 ，Node 的 模 
块 搜索 是 从 代码 执行 的 当前 目录 开始 的 。 因 此 ,搜索 结果 取决 于 你 当前 使 用 的 目录 , 也 就 是 取决 
于 当前 目录 中 node_modules 中 的 内 容 。 

如 下 图 所 示 ， 注 意 在 不 同 目录 下 列 出 的 模块 的 变化 。 
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Terminal 一 bash 一 87x27 


$ pwd 

UserszdavidherronxNode .JS2chapB3 
$ npm List 
/Users/davidherron/Node .JS 

| 一 gsyncea .1.9 

Fr connectel .4 .2 

| [一 9qs6a.1.6 

上 ejs@0 .4.2 

Fr express@2 .3.11 

| -一 9qs66.1.6 

-一 mimee@1l .2 .2 

$ cd ../chapae 

$ npm list 
/Users/davidherron/Node .JS/chapee 
| 一 colorsea .5.8 

| 一 ejsea .4.2 

Hr express@2.3.6 

| 上 一 connectQ@l .4 .1 

| mime@1 .2 .2 

| [一 9qs66.1.6 

-一 mongodbea .9 .4 

上 -一 mongoose@1 .3 .3 

-一 mongoqe@ae .日 .4 | 
一 openidee .1 .6 

-一 SqlLite362 .日 .12 

$1 














| 





默认 情况 下 ， 列 表 会 以 树 状 结构 显示 ， 上 面 这 样 的 截图 对 于 其 他 命令 来 说 并 不 是 特别 有 用 。 
通过 配置 parseable 可 以 让 数据 这 样 显示 ， 以 便于 使 用 。 


$ npm set parseable=true 

$ npm list 

/home/david/Node/chap06 

/home/david/Node/chap06/node modules/ejs 
/home/david/Node/chap06/node modules/express 
/home/david/Node/chap06/node modules/express/node modules/connect 
/home/david/Node/chap06/node modules/express/node modules/mime 
/home/david/Node/chap06/node modules/express/node modules/qs 
/home/david/Node/chap06/node modules/mongodb 
/home/david/Node/chap06/node modules/mongoose 
/home/david/Node/chap06/node modules/sqlite3 


6. Node 包 脚本 

npm 人 允许 Node 包 脚本 在 包 生命 周期 的 不 同时 间 自 动 执行 。 现 在 已 有 的 生命 周期 事件 是 测试 、 
启动 、 停 止 和 重新 启动 。 

一 个 npm 包 可 以 以 下 面 的 方式 进行 测试 : 

$ npm test <packageName> 

启动 、 停 止 和 重新 启动 这 些 生命 周期 事件 没有 一 个 固定 的 含义 。 明显 的 用 途 就 是 启动 或 者 停 
止 一 个 与 Node 包 相关 的 后 人 台 进 程 。 











i 
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7. 查看 和 编辑 Node 包 的 内 容 


npm 含 有 一 对 查看 /修改 包 内 容 的 命令 。 比 如 , 你 可 以 在 开发 的 时 候 使 用 这 对 命令 读 取 包 的 源 





文件 (理解 Node 包 的 作用 )， 查 看 Node 包 的 示例 目录 ， 或 者 修改 一 些 测试 补丁 。 
例子 如 下 。 





Terminal 一 bash 一 93x22 


$ pwd = 
Users/davidherron/Node .JS/chapBe 
$ npm explore mngoose 


txploring /Users/davidherron/Node .JS/chaptb/node_modules/mongoose 
Type "ex 让 ”or *D when finished 


bash-3.2$ pwd 

eUsersydavidherronyNode .JSychapa6ynode_modulesynongoose 

bash-3.2$ ls 

History .md README .md examp les Lib support 
Makefile docs index .js package .json test 
bash-3.2$ cd examples/ 

bash-3.2$ ls 

schema .js 

bash-3.2$ exit 

$ pwd 

A | 
$ 














就 像 我 们 在 终端 (命令 输出 ) 里 看 到 的 那样 ，sxplore 命 令 产 生 了 一 个 子 shell 程 序 ， 这 个 程 
序 的 当前 目录 是 模块 的 安装 位 置 。 输 入 exit 或 者 contro1-D 会 停止 该 shell 程 序 ， 并 返回 到 你 之 前 登 











录 时 的 shell 程 序 。 





如 果 有 需要 的 话 ， 你 可 以 在 浏览 包 内 容 的 时 候 编辑 文件 。 如 果 已 经 这 么 做 了 ,你 就 需要 像 下 


面 这 样 对 包 进行 一 次 重建 : 


$ npm rebuild mongoose 
mongoose@1.3.3 /home/david/Node/chap06/node modules/mongoose 


8. 更 新 已 安装 的 Node 包 


开发 者 会 经 常 更 新 他 们 的 Node 包 ， 除 非 你 跟 上 更 新 的 进度 ， 否 则 只 能 使 用 一 些 旧 的 特性 。 





下 面 的 命令 可 用 于 检查 包 是 不 是 已 经 过 时 : 


$ npm outdated 
express@2.3.6 ./node modules/express current=2.3.3 
mongoose@1.3.6 ./node modules/mongoose current=1.3.3 


它 会 展示 当前 已 安装 包 的 版 本 和 线 上 npm 仓 库 里 最 新 的 版 本 。 更 新 已 安装 的 Node 包 是 非常 
易 的 : 


$ npm update express 

connect@1.4.1 ./node modules/express/node modules/connect 
mime@1.2.2 ./node modules/express/node modules/mime 
qs@0.1.0 ./node modules/express/node modules/qs 
express@2.3.6 ./node modules/express 
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9. 卸载 已 安装 的 npm 包 

你 最 爱 的 Node 包 可 能 会 变 成 你 的 豆 梦 ， 而 且 你 还 可 能 会 有 其 他 很 多 理由 舍弃 已 经 安装 的 
Node 包 。 你 可 以 这 样 进行 印 载 : 

$ npm list 

/home/david/Node 

-一 一 openiade0.1.6 

$ npm uninstall openid 

$ npm list 

/home/david/Node 

(empty) 


10. 开发 和 发 布 npm 包 

现在 我 们 已 经 了 解 了 如 何 使 用 nppm， 接 下 来 看 一 下 npm 包 的 开发 。 有 一 些 npm 命 令 可 用 于 开 
发 过 程 。 

第 一 步 是 创建 一 个 package.json 文 件 ， 我 们 可 以 使 用 npm init 命 令 创建 初始 版 本 的 
package.json。npm 会 问 你 几 个 问题 ， 然 后 像 下 面 这 样 迅 速 帮 你 创建 如 下 内 容 : 

{ 

















"author": "I.M. Awesome <awesome@example.com>", 
"name": "tmod", 
"description": "Test Module", 
"vasom :00.1"; 
"repository": { 

hh i 
} 
"engines": { 

"node"s S041" 
} 
"dependencies": {}, 
"devDependencies": {} 


} 

第 二 步 就 是 创建 包 源 文件 。npm 没 有 提供 帮 你 完成 这 个 任务 的 方法 。 你 是 开发 者 ， 所 以 需要 
自己 写 代 码 。 注 意 ， 增 加 一 些 内 容 到 包 里 时 ， 你 需要 更 新 package. json 文 件 。 不 过 npm 还 是 提 
供 了 一 些 命令 让 你 在 开发 Node 包 的 时 候 使 用 。 

其 中 一 个 命令 是 npm 1ink, 一 个 包 的 轻 量 级 安装 方法 。 和 npm instal1 方 法 的 不 同 之 处 在 
于 ，npm 1ink 只 是 设置 了 一 个 连接 到 你 的 源 文件 目录 的 符号 链接 ， 然后 你 可 以 自由 编辑 包 文件 ， 
而 不 需要 在 包 有 变化 的 时 候 重 新 打包 和 更 新 ,你 可 以 反复 在 一 个 包 上 修改 和 测试 ,不 用 经 常 重建 。 

npm 1ink 命 令 的 使 用 分 两 个 步骤 ,首先 你 要 将 自己 的 项 目 链接 到 Node 安 装 程序 上 ， 如 下 所 示 : 


$ cd tmod 
$ npm link 
../../0.4.7/lib/node modules/tmod -> /home/david/Node/chap03/tmod 


第 二 步 ， 将 Node 包 链接 到 你 的 应 用 里 : 


$ npm link tmod 
../node modules/tmod -> /home/david/Node/0.4.7/lib/node modules/tmod -> 
/home/david/Node/chap03/tmod 
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箭头 〈-> ) 显示 了 由 以 上 命令 生成 的 符号 链接 链 。 

npm install 安 装 命令 在 开发 过 程 中 有 两 种 模式 。 第 一 种 是 在 Node 包 目录 的 根 目录 下 执行 的 
时 候 ， 它 会 将 当前 目录 和 依赖 关系 安装 到 本 地 的 node_modules 目 录 。 

第 三 种 是 利用 一 个 本 地 文件 或 者 通过 一 个 URL 利 用 网 络 安 装 压缩 的 Node 包 ,大 部 分 源 代码 控 
制 系统 支持 一 个 以 树 形 源 代码 打包 的 tarball 文 件 (已 经 打包 好 的 tar 文 件 )。 例 如 ， 在 github 项 目 上 
的 下 载 页 提供 了 一 个 这 样 的 URL: 


$ npm install https://github.com/havard/node-openid/tarball/v0.1.6 
openid@0.1.6 ../node modules/openid 


当 你 对 自己 的 Node 包 感到 满意 时 , 或 许 会 希望 将 其 发 布 到 公共 的 npm 仓 库 , 这 样 其 他 人 也 能 
体验 一 下 你 的 Node 包 。 

首先 我 们 需要 在 npm 仓 库 上 注册 一 个 账号 。 我 们 可 以 运行 npm adduser 命 令 来 完成 注册 ， 注 
册 时 会 有 一 系列 问题 要 回答 并 填写 ， 以 设置 用 户 名 、 密 码 和 电子 邮件 地 址 。 

$ npm adduser 

Username: my-user-name 


Password: 
Email: me@Qexample.com 


下 一 步 我 们 要 在 对 应 Node 包 的 根 目录 下 运行 npm publish 命 今 : 

$ npm publish 

如 果 上 面 的 操作 一 切 正 常 ， 在 npm publish 执 行 结束 之 后 ,你 可 以 访问 http://search. 
npmjs.org， 然 后 搜索 Node 包 。 搜 索 结 果 很 快 就 会 显示 出 来 。 

顾名思义 ，npm unpublish 命 令 可 以 将 Node 包 从 npm 仓 库 里 移 除 。 

11. npm 的 配置 

我 们 已 经 在 之 前 全 局 模式 和 本 地 模式 的 比较 中 配置 过 npm， 但 还 有 一 些 其 他 的 设置 可 调 优 
npm 的 运行 。 让 我 们 先 看 下 配置 方式 。 

首先 是 npm set 和 npm get 命 令 ， 具体 配置 方式 为 : 

npm config set <key> <value> [--globall 

npm config get <key> 

npm config delete <key> 

npm config list 

npm config edit 


npm get <key> 
npm set <key> <value> [--globall 


具体 例子 如 下 : 


$ npm set color true 

$ npm set global false 
$ npm config get color 
true 

$ npm config get global 
false 
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环境 变量 也 可 以 用 来 配置 hppm。 所 有 以 NPM_CONFIG_ 开 头 的 变量 都 是 npm 的 配置 项 。 例 如 ， 
NPM_CONFIG_GLOBAL 用 于 设置 全 局 的 配置 global 的 值 。 
可 以 放 到 配置 文件 里 的 配置 值 : 


D SsHOME/ .npmrc 

















DQ <Node Install Directory>/etc/npmrc 
配置 文件 里 的 键 值 对 如 下 ， 键 值 对 会 在 npm config set 命 令 执行 后 自动 更 新 : 


$ cat ~/ .npmrc 
global = false 
color = true 











3.2.4 ”Node 包 版 本 的 标识 和 范围 


Node 无 法 识别 任何 和 版 本 号 相关 的 内 容 。 它 能 识别 模块 , 而 且 会 像 对待 一 个 模块 一 样 对 待 目 
录 结 构 ， 它 具有 功能 相当 丰富 的 模块 查找 系统 ,但 是 它 无 法 识别 版 本 号 。 然 而 ，npm 是 可 以 识别 
版 本 号 的 。 它 使 用 了 Semantic Versioning 模 式 ( 在 后 面 介绍 )， 就 像 我 们 已 经 看 到 的 ， 我们 可 以 通 
过 网 络 安装 模块 ， 查 找 旧 版 的 模块 并 用 npm 对 其 进行 更 新 。 所 有 这 些 都 属于 版 本 控制 的 范畴 ， 那 
么 让 我 们 仔细 看 看 有 了 版 本 号 和 版 本 标签 之 后 npm 可 以 做 的 事情 。 

之 前 我 们 曾 使 用 npm 1ist 命 令 列 出 已 安装 的 包 ， 列 表 包 括 了 已 安装 包 的 版 本 号 。 如 果 你 希 
望 看 到 一 个 特定 模块 的 版 本 号 ， 可 以 输入 下 面 的 命令 : 


$ npm view express version 
2.4.0 


当 npm 命 令 参数 中 包含 包 名 ， 你 可 以 指定 一 个 版 本 号 或 者 版 本 标签 。 如 果 需 要 的 话 你 可 以 通 
过 这 个 方式 处 理 特定 的 包 版 本 。 例 如 ,如 果 你 已 经 在 测试 环境 对 某 个 特定 的 版 本 完成 了 测试 并 证 
明 其 可 用 ,那么 就 能 保证 这 个 版 本 能 部 署 到 生产 环境 中 了 : 

$ npm install express@2.3.1 

mime@1.2.2 ./node modules/express/node modules/mime 

connect@1.5.1 ./node modules/express/node modules/connect 


qs@0.2.0 ./node modules/express/node modules/qs 
express@2.3.1 ./node modules/express 


npm 有 “标签 ”这 个 概念 ， 我 们 可 以 利用 它 并 用 下 面 这 样 的 命令 安装 最 新 版 本 的 、 稳 定 的 
Node 包 。 




































































$ npm install sax@stable 

标签 名 字 可 以 是 任意 字符 ， 而 且 不 是 必需 的 。 包 的 作者 可 以 指定 标签 名 ， 且 并 不 是 所 有 的 包 
都 使 用 标签 名 。 
Node 包 的 package. json 里 会 列 出 与 其 他 包 的 依赖 关系 ， 你 可 以 这 样 查看 : 


$ npm view mongoose dependencies 
{ hooks: '0.1.9' } 











Ps 











$ npm view express dependencies 


wi 
驳 
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{ connect: '>= 1.5.1 < 2.0.0'， 
mime: '>= 0.0.1', 
qs: '>= 0.0.6' } 


npm 和 需要 按照 包 的 依赖 关系 决定 安装 哪些 模块 。 当 安装 一 模块 包 的 时 候 ， 它 会 查看 声明 的 依 
赖 关 系 ， 然 后 下 载 那 些 未 安装 的 模块 。 
眼 尖 的 读者 可 能 已 经 看 到 这 个 例子 里 的 小 于 号 和 大 于 号 了 。npm 支 持 版 本 号 范围 的 声明 ， 比 
如 当 Express 做 了 这 个 声明 时 ， 它 在 Connect 1.51 ~ 2.0.0 版 本 下 都 可 以 正常 运行 。 
npm 背 后 有 一 个 规则 做 指导 ， 这 可 能 对 于 一 个 一 直 和 软件 打交道 的 人 来 说 很 简单 也 很 普通 。 
npm 作 者 使 用 http://semver.org 上 的 Semantic Versioning 标 准 作 为 npm 版 本 号 系统 的 指导 标准 ， 如 下 
所 示 。 
口 版 本 字符 串通 常 都 是 YZ 形式 的 整数 ， 其 中 XX 是 主 版 本 ，7 是 副 版 本 ，2Z 是 日 常 补 丁 的 版 
本 ， 例 如 1.2.3。 
口 版 本 字符 串 的 补丁 号 后 可 以 有 一 个 任意 的 文本 ， 我 们 通常 叫 它 “特别 版 本 ”， 例 如 
1.2.3betal。 
口 版 本 字符 串 的 比较 不 是 一 般 的 字符 串 比较 , 而 是 一 种 数值 比较 , 也 就 是 比较 *、Y、2Z 的 值 。 
例如 ，1.9.0 < 1.10.0 < 1.11.3 ，1.0.0betal < 1.0.0beta2 < 1.0.0。 
口 用 版 本 号 来 记录 兼容 性 。 
时 XX 值 为 0 的 包 肯 定 是 不 稳定 的 ， 任 何 API 都 有 可 能 随时 改变 。 
m 如 果 只 是 做 了 向 前 兼容 的 bug 修 复 ，Z 的 值 (补丁 号 ) 必须 递增 。 
里 如 果 引 入 了 向 前 兼容 的 函数 ，Y 值 必须 递增 〈 比如 ， 一 个 新 的 函数 引入 ， 不 过 所 有 其 他 
函数 都 还 是 兼容 的 )。 
和 当 与 之 前 版 本 有 冲突 的 改变 出 现时 ，X 的 值 就 得 递增 。 


































































































3.2.5 ”CommonJS 模块 





Node 的 模块 系统 是 基于 CommonJS ( http:/www.commonjs.org/ ) 模块 系统 的 。 虽 然 JavaScript 
是 一 门 强大 的 语言 ， 含 有 很 多 高 级 的 特性 ( 比如 对 象 和 闭 包 )， 但 是 它 缺 少 一 个 标准 对 象 库 来 辅 
助 构建 应 用 。CommonJS 旨 在 填补 这 个 缺口 ， 同 时 提供 了 一 个 实现 JavaScript 模 块 的 约定 和 一 系列 
标准 模块 。 

recquire 国 数 以 模块 标识 符 作 为 参数 ,返回 模块 对 外 开放 的 接口 。 如 果 要 加 载 的 模块 又 引用 
了 其 他 模块 ,后 者 也 要 被 加 载 。 模 块 包括 在 一 个 JavaScript 文 件 中 ，CommomJS 并 不 指定 模块 标识 
符 对 应 文件 名 的 方式 。 

模块 提供 了 一 个 简单 的 封装 机 制 去 隐藏 本 身 的 实现 方式 ， 而 暴露 出 一 个 API。 模 块 内 容 就 是 
JavaScript 代 码 ， 就 像 是 以 如 下 的 方式 编写 : 

(function() { ... contents of module file ... })(); 

这 样 的 方式 将 模块 的 所 有 顶级 对 象 隐藏 在 一 个 私有 的 命名 空间 中 , 使 其 他 代码 无 法 访问 。 这 

就 是 全 局 对 象 污染 问题 的 解决 方案 ( 稍 后 详细 介绍 )。 
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模块 对 外 开放 的 API 即 是 require 函 数 返回 的 对 象 。 在 模块 内 部 ， 这 个 API 是 由 exports 对 


象 实 现 的 ，exports 的 字段 包含 被 暴露 的 API。 为 了 从 模块 中 暴露 出 一 个 函数 或 者 对 象 ， 我 们 只 
需要 将 其 注册 到 exports 对 象 里 。 


里 的 
比如 


模块 封装 演示 

让 我 们 看 一 个 例子 ， 先 创建 一 个 含有 如 下 代码 的 modulel .js: 
var A = "value A 
Var B = "Value B"; 
exports.values = function() { 


return { A: A, B: B }; 
} 


然后 创建 一 个 含有 下 面 代 码 的 module2. = 


var util 





= require('util'); 
var A = "a different value A"; 
var B = "a different value B"; 
Var ml = require('./modulel'); 
util.log('A='+A+' B='+B+' values='+util.inspect (ml.values())); 


在 Node 里 运行 : 


$ node module2.js 
19 May 21:36:30 - A=a different value A B=a different value B values={ A: 'value A', 
B: 'value B' } 


这 个 例子 展示 了 模块 内 部 值 的 封装 方法 ， 它 使 得 modulel . js 里 的 A 和 B 并 不 会 覆盖 modqule2 .js 
A 和 B， 因 为 它们 是 被 封装 在 modulel .js 内 的 。 模 块 内 部 经 过 封装 的 值 也 可 以 暴露 给 外 部 ， 
module1.js 里 的 .values 函 数 。 

之 前 提 到 的 全 局 对 象 问题 和 全 局 环境 内 的 变量 有 关 。 在 Web 浏 览 锅 里 ， 有 一 个 全 局 的 执行 上 








下 文 ， 如 果 一 个 JavaScript 脚 本 修改 了 在 其 他 脚本 中 使 用 的 全 局 变量 ， 这 会 造成 很 多 问题 。 对 于 
CommonJS 模 块 ， 每 一 个 模块 都 有 自己 的 私有 全 局 执行 环境 ， 这 样 模 块 内 的 多 个 函数 共享 变量 也 


<4 旦 
变 得 


3.3 


内 容 


较为 安全 ， 不 用 担心 会 影响 其 他 模块 中 的 全 局 变量 。 
小 结 


这 一 章 我 们 学 习 了 很 多 关于 Node 模 块 和 包 的 内 容 ， 上 有 具体 内 容 包括 

口 实现 Node 模 块 和 包 ; 

口 管理 安装 的 模块 和 包 ; 

口 Node 如 何 定位 模块 。 

学 习 了 Node 模 块 和 包 , 接 下 来 就 该 在 构建 应 用 的 时 候 使 用 它们 了 , 这 也 正 是 下 一 章 要 介绍 的 


Le 














第 4 章 


几 种 典型 的 简单 应 用 








学 习 完 Node 模 块 之 后 , 接 下 来 就 是 学 以 致 用 的 时 候 了 。 在 这 一 章 里 , 我 们 会 尽量 保持 应 用 足 
够 简单 ， 从 而 可 以 把 研究 重点 放 在 3 个 不 同 的 Node 应 用 框架 上 。 之 后 几 章 我 们 会 做 一 些 复杂 的 应 
用 ,俗话 说 得 好 : 学 会 跑 之 前 ， 得 先 学 会 走 。 

开始 吧 。 





4.1 Math Wizard 


在 这 一 章 , 我 们 所 要 做 的 就 是 一 个 简单 的 Math Wizard 应 用 。Math Wizard 的 用 户 体验 很 不 错 ， 
适合 用 于 对 儿童 讲授 算术 。 由 于 我 们 没有 擅长 用 户 体验 的 行家 ， 所 以 做 出 来 的 Math Wizard 应 用 
只 能 用 于 对 Node 使 用 者 讲授 Web 应 用 开发 。 有 一 点 需要 事先 提醒 下 , 不 要 期 望 你 的 孩子 能 够 通过 
这 个 应 用 成 为 数学 天 才 。 

Math Wizard 应 用 包括 了 主页 、 侧 边 导 航 栏 和 其 他 几 个 允许 用 户 进行 算术 操作 的 页 面 。 











是 否 使 用 Web 框架 


Web 框 架 可 以 让 你 从 复杂 的 HTTP 协 议 实 现 中 解脱 出 来 。 远 离 细 节 是 一 个 程序 员 保持 高 效 的 
工作 方式 。 当 你 使 用 一 个 库 或 者 框架 , 而 这 个 库 或 者 框架 提供 了 很 多 封装 好 的 函数 来 帮助 处 理 细 
节 时 ， 这 个 感觉 会 特别 明显 。 

在 这 一 章 , 我 们 会 先 从 编写 一 个 不 依赖 于 框架 的 应 用 ( Math Wizard ) 开始 , 然后 使 用 Connect 
和 Express 分 别 进行 渐进 增强 式 的 开发 。 


4.2 不 依赖 框架 的 实现 


我 们 先 循序 渐进 学 习 Node 应 用 的 构建 ， 
Node 的 核心 包 HTTP Server 对 象 开 始 学 起 。 

和 其 他 Web 应 用 一 样 ，Math Wizard 包 含 很 多 页 面 ,每 个 页 面 对 应 一 个 URL。 每 个 页 面 都 有 一 
些 常见 的 元 素 〈 常用 的 页 面 结构 和 导航 栏 )， 不 过 每 个 页 面 的 内 容 是 不 同 的 。 在 Math Wizard 中 ， 
URI 规 则 如 下 : 








如 感受 Web 框 架 带 来 的 便捷 。 这 意味 着 我 们 要 从 
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口 / wizard 应 用 的 主页 ; 

口 square ”用 于 计算 一 个 数 的 平方 ; 
口 /mult 用 于 计算 两 个 数 相 乘 ; 

口 /factorial 用 于 计算 一 个 数 的 阶乘 ; 
口 /fibonacci 用 于 计算 斐 波 那 契 数 。 
我 们 先 创建 一 个 文件 夹 来 存放 源 代 码 : 


$ mkdir chap04 


4.2.1 路 由 请 求 


Math Wizard 的 每 一 个 页 面 都 是 由 一 个 独立 的 模块 实现 ， 然 后 服务 器 把 请 求 分 别 路 由 到 这 些 
模块 。 

我 们 所 指 的 “请 求 的 路 由 选择 ”就 是 一 种 把 应 用 切 分 成 多 个 模块 的 方式 。 与 其 在 一 个 庞大 的 
回调 函数 中 实现 应 用 的 每 一 个 细节 ,不 如 使 用 模块 化 的 处 理 方式 。 请 求 的 路 由 选择 首先 需要 有 代 
码 对 进来 的 HTTP 请 求 进行 检查 ， 然 后 调用 对 应 的 模块 处 理 请 求 。 

创建 一 个 app-node .js， 其 所 包含 内 容 如 下 : 

var tt pot :SS L243 



































var http 
var htutil 


= require('http'); 

= TedqUire(™ /tutlL"): 

Var server = http.createServer (function (req, res) { 
htutil.loadParams (req, res, undefined); 





if (req.requrl.pathname === '/') { 
require('./home-node') .get (req, res); 

} else if (req.requrl.pathname === '/square') { 
require('./square-node') .get (req, res); 

} else if (regq.requrl.pathname === '/factorial') { 
require('./factorial-node') .get (reqgq, res); 

} else if (regq.requrl.pathname === '/fibonacci') { 
require('./fibo-node') .get (req, res); 
// require('./fibo2-node') .get (req, res); 

} else if (req.requrl.pathname === '/mult') { 
require('./mult-node') .get (req, res); 

} else { 
res.writeHead(404, { 'Content-Type': 'text/plain' }); 


res.end("bad URL "+ req.url); 
} 
} 


server.listen(http_port); 
console.log('listening to http://localhost:8124'); 


这 个 请 求 路 由 器 是 非常 简单 的 。 每 一 个 HTTP 请 求 的 回调 函数 都 使 用 了 rea 变 量 来 持 有 请 求 
的 数据 ，res 用 来 持 有 响应 数据 。 这 一 请 求 路 由 融会 检查 请 求 的 URL， 然 后 将 请 求 转发 到 对 应 的 
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这 一 应 用 由 一 些 模 块 组 成 ， 这 些 模 块 分 别 对 应 一 个 页 面 且 都 暴露 了 一 个 叫做 .get 的 函数 。 
这 个 函数 使 用 了 function (req，res) 语 句 来 实现 Math Wizard 中 的 一 个 页 面 。 

如 果 请 求 的 URL 没 有 匹配 任何 模块 ， 我 们 会 返回 一 个 404 状 态 码 ， 这 个 状态 码 说 明 对 应 的 页 
面 没 有 找到 。 








4.2.2 处理 URL 查询 参数 


htutil.loadParams 晴 数 可 以 帮助 我 们 完成 URL 的 解析 并 保存 解析 后 的 对 象 ， 这 样 Math 
Wizard 应 用 的 其 他 部 分 也 可 以 引用 这 个 对 象 。 每 一 个 页 面 都 会 包括 一 个 输入 为 a 和 b 的 表单 。 当 用 
户 输入 数字 并 点 击 提交 按钮 Submit 时 ，URL 会 包含 一 个 查询 字符 串 ， 如 下 所 示 : 

http://localhost:8124/mult?a=3&b=7 

这 些 查询 参数 只 会 在 输入 数字 并 点 击 提交 按钮 的 时 候 生 成 。 这 意味 着 每 一 个 Math Wizard 页 
面 必须 同时 兼容 参数 存在 和 不 存在 的 情况 。hntutil.1loadParams 隐 数 可 以 很 方便 地 查找 这 些 参 
数 ， 从 而 减少 各 个 模块 中 重复 的 代码 。 

创建 一 个 htutil.js， 使 其 包含 如 下 的 代码 : 


var url = require('url'); 
exports.loadParams = function(req, res, next) { 
req.requrl = url.parse(req.url, true); 
regq.a = (req.requrl.query.a && !isNaN(reqg.requrl .query.a)) 
? new Number (reqgq.requrl .query.a) 
: NaN; 
red.b = (req.requrl.query.b && !isNaN(req.requrl.query.b)) 
? new Number (reqgq.requrl .gquery.b) 
: NaN 
if (next) next(); 








} 
loadqParams 国 数 会 由 HTTP 请 求 处 理 函 数 调用 , 并 接收 HTTP 请 求 处 理 函 数 传递 的 red 和 res 
参数 。 它 会 查找 a 和 pb 对 应 的 查询 参数 ,并 将 其 添加 到 rea 对 象 里 。 例 子 中 我 们 使 用 : ?运算 符 来 确 
保 req.a 和 req.pb 拥 有 值 NaN 或 者 一 个 数字 ， 这 取决 于 查询 参数 是 否 存 在 ， 以 精简 其 他 代码 。 现 
在 你 可 以 先 忽 略 名 为 next 的 函数 ,我们 会 在 后 面 介绍 Connect 框 架 时 讨论 这 个 方法 。 
在 htutil.js 里 还 有 另外 两 个 函数 ， 它 们 负责 页 面 布局 的 处 理 。Math Wizard 给 每 个 页 面 提 
供 了 一 个 通用 的 布局 ,布局 代码 的 集中 处 理 可 以 减少 重复 的 代码 。 在 稍 后 使 用 Express 框 架 的 时 候 ， 
我 们 可 以 使 用 模板 文件 来 控制 页 面 布局 ， 但 是 现在 在 这 一 版 Math Wizard 中 我 们 只 使 用 Node 的 核 
心 部 分 ， 自 然 也 就 不 使 用 模板 了 。 
在 htutil.js 里 ， 我 们 继续 添加 下 面 两 个 函数 。 它 们 是 两 个 帮助 构造 页 面 的 效用 函数 。 
exports .navbar = function() { 
return ["<div class='navbar'>", 
"<p><a href='/'>home</a></p>", 
"<p><a href='/mult'>Multiplication</a></p>", 


"<p><a href='/square'>Square's</a></p>", 
"<p><a href='/factorial'>Factorial's</a></p>", 
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"<p><a href='/fibonacci'>Fibonacci's</a></p>", 
本 了 区 OLm( tT NR) 
} 
这 个 函数 提供 了 用 于 链接 其 他 页 面 的 HTML 片 段 。 它 可 以 作为 一 个 导航 栏 ， 使 用 户 通过 它 访 


问 应 用 的 各 个 页 面 。 


exports.page = function(title, navbar, content) { 
return ["<html><head><title>{title)</title></head>", 

"<body><hl>{title}</h1l>", 
"<table><tr>", 
"<td>{tnavbar}</td><ta> {tcontent}</tas™, 
"</tr></table></body></html>" 
] .join('\n') 
.replace("{title}", title, "g") 
.replace("{navbar}", navbar, "g") 
.replace("{content}", content, "g"); 


} 

这 个 函数 对 应 的 是 整个 页 面 的 HTML 结 构 。 它 调用 了 一 些 参 数 来 填充 标题 、 导 航 栏 和 页 面 的 

我 们 在 这 里 使 用 了 正则 表达 式 和 replace 函 数 ， 从 而 可 以 很 方便 地 将 数据 蔡 换 为 字符 串 。 
replace 冰 数 是 一 个 字符 串 函 数 , 它 使 用 了 一 个 正则 表达 式 来 匹配 字符 串 , 然后 用 提供 的 字符 串 
替换 匹配 成 功 的 文本 。 

下 一 节 我 们 会 介绍 如 何 使 用 这 些 函 数 。 


























4.2.3 ”乘法 运算 
现在 让 我 们 看 下 如 何在 Math Wizard 里 创建 一 些 能 够 进行 数学 运算 的 页 面 。 首 先 要 实现 的 是 


乘法 (比如 ax*b ) 页 面 。 
创建 一 个 mult-nodqe.js， 使 其 包含 下 面 的 代码 : 


var htutil = require('./htutil'); 
exports.get = function(req, res) { 
res.writeHead(200, { 
'Content-Type': 'text/html' 
js 
Var result = req.a * req.b; 


res.endl( 
htutil.page ("Multiplication", htutil.navbar(), I[ 


(!isNaN(req.a) && !isNaN(req.b) ? 
("<p class='result'>{a} * {b} = {result}</p>" 

.replace("{a}", req.a) 

.replace("{b}", req.b) 

.replace("{result}", req.a * req.b)) 

a 

"<p>Enter numbers to multiply</p>", 
"<form name='mult' action='/mult' method='get'>", 
"A: <input type='text' name='a' /><br/>", 
"BB: <input type='text" name=s"l" />", 
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"<input type='submit' value='Submit' />" 
Tae/ fOr 
lsjolmt" AN 让) 
jy 
} 





和 其 他 Math Wizard 模 块 一 样 ， 乘 法 模块 有 两 个 目的 。 首 先是 显示 算术 结果 ， 然 后 是 显示 一 
个 让 用 户 输入 数字 ( 一 个 或 两 个 ) 的 表单 ， 用 于 乘法 运算 。 

首先 要 注意 的 是 我 们 使 用 了 htutil.page 函 数 。 它 提供 了 总 体 的 页 面 布局 控制 功能 ， 在 这 
个 函数 里 ， 我 们 只 提供 页 面 的 主要 内 容 区 域 。 这 个 内 容 区 域 是 一 个 字符 串 数 组 ， 最 后 会 被 
用 .join () 函数 联接 起 来 。 

















如 果 用 户 提 供 了 一 个 参数 ， 那 么 最 关键 的 部 分 就 是 按照 下 面 的 代码 显示 结 是 


日 
邱 木 : 








(!isNaN(regq.a) && !isNaN(req.b) ? 
("<p class='result'>{a} * {b} 
.replace("{a}", reqg.a) 
.replace("{b}", reqg.b) 
.replace("{result}", 


ny) 


= {result}</p>" 


req.a * req.b)) 





这 个 例子 使 用 了 ? : 运算 符 来 检查 参数 是 否 已 经 提供 ， 如 果 提 供 了 , 那么 对 reg .a 和 rea.b 进 
行 乘法 运算 并 显示 结果 。 


4.2.4 其 他 数学 函数 的 执行 


其 他 的 Math Wizard 模 块 和 mult -node .js 类 似 ,使 用 一 样 的 模式 创建 ,让 我 们 快速 了 解 一 下 。 
一 个 数 的 平方 是 这 个 数 乘 以 它 本 身 ( 比如 a*a )。 创建 square-nogde.js， 使 其 包含 下 面 的 
代码 。 注 意 ， 我 们 使 用 了 Math .floor 方法 来 确保 对 rea.a 的 值 取 整 。 

var htutil = require('./htutil'); 

exports.get = function(regqg, 











res) { 
res.writeHead(200, { 
'Content-Type': 'text/html' 
} :3 
res.endl( 


htutil.page ("Square", htutil.navbar(), [ 
(!isNaN(req.a) ? 
("<p class='result'>{a} squared 
.replace("{a}", req.a) 
.replace("{sq}", req.a*req.a)) 


: "mm)y 


"<p>Enter a number to see its square</p>", 
"<form name='square' 


= {sq}</p>" 


action='/square' method='get'>", 
"A: <input type='text' name='a' />", 
Te ESPmS" 
J]:joln( \n")) 
De: 
3 





an 的 阶乘 ， 用 数学 表达 式 表 示 是 n!。 它 是 n 及 所 有 小 于 n 的 正 整 数 相 乘 的 结果 。 阶 乘 运算 在 数 
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学 的 很 多 领域 都 会 用 到 。 接 下 来 创建 一 个 factorial-node.js， 使 其 包含 下 面 的 代码 : 


Var htutil = require('./htutil'); 
Var math = require('./math'); 


exports.get = function(req, res) { 
res.writeHead(200, { 
'Content-Type': 'text/html' 
} 
res.end!( 
htutil.page ("Factorial", htutil.navbar(), [ 
(!isNaN(req.a) ? 
("<p class='result'>{a} factorial = {fact}</p>" 
.replace("{a}", req.a) 
.replace("{fact}", 
math.factorial (Math.floor(req.a)))) 
Wjy 
"<p>Enter a number to see it's factorial</p>", 
"<form name='factorial' action='/factorial' method='get'>", 
"A: <input type='text' name='a' />", 
"</form>" 
] .join('\n')) 
) 





斐 波 那 契 数 就 是 如 下 顺序 的 一 组 整数 ， 0、1、1、2、3、5、8、13、21、34、55 等 。 




















斐 波 那 


契 数 列 中 的 每 个 数 都 是 它 前 两 个 数 之 和 。 连 续 数 的 ee 括 于 黄金 比例 。 让 我 们 创建 一 个 名 为 





fibo-noqe.js 的 文件 ， 用 于 创建 计算 斐 波 那 契 数 的 页 


var htutil = require('./htutil'); 
Var math = require('./math'); 
exports.get = function(req, res) { 
res.writeHead(200, { 
'Content-Type': 'text/html' 
3 
res.endl( 
htutil.page ("Fibonacci", htutil.navbar(), [ 
(!isNaN(req.a) ? 
("<p class='result'>fibonacci {a} = {fibo}</p>" 
.replace("{a}", Math.floor(req.a)) 
.replace("{fibo}", math.fibonacci (Math.floor(req.a)))) 
jn 
"<p>Enter a number to see its fibonacci</p>", 
"<form name='fibonacci' action='/fibonacci' method='get'>", 
"A: <input type='text' name='a' />", 
Vs/ Ori 
]15o0Ln (Nn) 
有 
} 


一 些 眼 尖 的 读者 可 能 已 经 注意 到 一 个 叫做 math 的 模块 。 这 个 模块 包含 了 一 些 数学 
现 。 我 们 需要 创建 一 个 math .js 文件 ， 使 其 包含 下 面 的 代码 : 


Var factorial = exports.factorial = function(n) { 





函数 的 


A 


头 
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至 二 并 入 三 反思) 
return 1; 
else 
return n * factorial (n-1); 


Var. fiDonaceei Ss Exporta. fibonaeei = fanetion(n) { 
上 ”人 和 : 生 宇 宇宙) 
return 1; 
else if (n === 2) 
return 1; 
else 





return fibonacci(n-1) + fibonacci (n-2); 








这 些 方 法 简单 地 实现 了 一 些 标准 的 数学 函数 。 就 像 我 们 能 马上 看 到 的 ， 斐 波 那 契 函数 是 一 个 
非常 简单 的 计算 密集 型 函数 。 
我 们 希望 Math Wizard 应 用 能 有 一 个 主页 。 创 建 一 个 homenode .js， 使 其 包含 下 面 的 代码 : 


Var htutil = require('./htutil'); 


exports.get = function(req, res) { 
res.writeHead(200, { 
'Content-Type': 'text/html' 
过 
res.end( 


Ptutil.page("Math Wizard", 
htutil.navbar(), 
"<p>Math Wizard</p>") 

je 





A 0, 

















Math Wizard 
[<|» || 仿 | [| ATA||+ |@http://localhost:8124/ |(Qrcooge )» 
由 Math Wizard + 
Math Wizard 
ho 


Multiplication 
Square's Math Wizard 
Factorial's 


Fibonacci's 
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输入 下 面 的 命令 : 

$ node app-node.js 

为 app-node .js 监听 了 8124 端 口 , 所 以 访问 http://localhost:8124/ 的 时 候 我 们 可 以 看 到 下 面 
的 内 容 。 


4.2.5 ”扩展 Math Wizard 


我 们 的 孩子 需要 高 质量 的 教育 , 而 这 个 示例 程序 只 是 可 教授 算术 的 基本 应 用 , 但 也 许 并 不 适 
合 。 数 学 运算 是 多 种 多 样 的 ， 因 此 任何 情况 下 ， 我 们 都 可 以 很 轻易 地 扩展 Math Wizard， 为 其 添 
加 其 他 页 面 。 遵 循 已 有 的 模式 给 Math Wizard 添 加 一 个 新 的 页 面 需要 用 到 下 面 几 个 步 又 。 
口 在 htutil.navbar 上 添加 一 个 a 标签 。 
为 htutil.navbar 函 数 包 含 了 针对 导航 栏 的 HTML 代 码 ， 任 意 一 个 新 的 Math Wizard 页 
面 都 需要 被 像 下 面 这 样 列 出 页 面 的 URL 和 页 面 的 名 字 : 
"<p><a href='/newUrl'>Math Function Name</a></p>\n"+ 
口 在 app-node .js 里 增加 一 条 if 语 句 。 
因为 app-noge .js 文件 包含 请 求 的 路 由 功能 ， 所 以 需要 一 个 新 的 if 语 句 实现 我 们 刚刚 定 
义 的 URL 的 转发 。 这 个 URL 需 要 匹配 htutil .navbar 捕 数 里 的 URL。 


























if (req.requrl.pathname === '/newUrl') { 
require('./moduleName') .get (req, res); 


} 

口 增加 一 个 页 面 处 理 函 数 模块 ， 对 外 暴露 一 个 get 方 法 。 

我 们 之 前 已 经 看 到 一 些 处理 函 数 模块 (mult-node. js 等 )， 按 照 那些 例子 再 创建 一 个 这 
种 模块 还 是 很 容易 的 。 
4.2.6 ”长 时 间 运 行 的 运算 〈 斐 波 那 契 数 ) 

应 用 Math Wizard 展 示 了 Node 应 用 中 一 个 饱 受 批评 的 缺点 。 如 果 回 调 函数 不 能 对 请 求 进行 快 
速 的 处 理 并 返回 Node 事 件 循 环 ， 应 用 就 会 陷入 泥潭 。 

为 了 让 大 家 更 直观 地 了 解 这 个 缺点 ， 我 们 可 以 在 斐 波 那 契 数 计算 页 面 上 输入 一 个 很 大 的 数 ， 
比如 50。 这 样 就 需要 大 量 的 时 间 来 执行 运算 (大概 需要 几 个 小 时 到 几 天 )，Node 进 程 的 CPU 占用 
率 会 变 高 ， 然 后 在 其 他 浏览 器 窗口 内 ， 你 可 能 无 法 使 用 Math Wizard 了 。 所 有 这 一 切 都 是 因为 斐 
波 那 契 序列 的 数 的 计算 是 非常 庞大 的 任务 。 为 什么 浏览 器 也 会 无 响应 ? 这 是 因为 密集 型 计算 阻止 
了 Node 事 件 循环 的 执行 ， 从 而 阻止 了 Node 对 浏览 器 请 求 进行 的 响应 。 

由 于 Node 只 有 一 个 执行 线程 , 请 求 处 理 程序 必须 在 执行 完 之 后 快速 返回 事件 循环 。 通常 , 异 
步 编程 能 保证 事件 循环 正常 执行 。 甚 至 在 加 载 地 球 另 一 端的 服务 器 数据 时 ,异步 编程 的 作用 也 能 
体现 出 来 ， 因 为 1O 是 非 阻塞 的 ， 控 制 能 很 快 返回 给 事件 循环 。 因 为 我 们 选择 的 简单 斐 波 那 契 函 
数 是 一 个 长 时 间 运 行 的 阻塞 型 计算 , 所 以 它 并 不 适用 于 这 一 模型 。 这 样 的 事件 处 理 程序 会 让 系统 
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不 用 忙于 处 理 请 求 ， 并 i 上 Node 从 即将 处 理 的 事务 中 解脱 出 来 ， 从 而 实现 一 个 极 快 的 Web 服 务 妖 。 

在 这 个 例子 里 ,长 时 间 运 行 的 计算 导致 的 问题 ( 长 响应 时 间 问 题 ) 很 明显 。 用 于 响应 斐 波 那 
契 数 的 时 间 几 乎 让 你 有 时 间 去 西藏 进行 一 次 欢快 的 旅行 。 长 响应 时 间 可 能 在 你 的 应 用 中 不 是 很 明 
显 ， 那 么 你 如 何 知道 自己 的 请 求 会 占用 太 多 时 间 呢 ? 一 个 测量 手段 就 是 利用 浏览 器 工具 ( 比如 
YSlow ) 显示 的 响应 延迟 。 用 户 使 用 浏览 器 的 时 候 ， 能 在 一 两 秒 内 显示 下 一 页 是 很 重要 的 ， 和 否则 
你 将 有 可 能 失去 你 的 用 户 。 

在 Node 里 有 两 种 解决 这 类 问题 的 常见 方案 。 

口 算法 重 构 ”就 像 我 们 选择 的 斐 波 那 契 函数 一 样 ， 非 最 佳 的 算法 可 以 通过 重 写实 现 更 高 的 

效率 。 或 者 ， 即 使 没有 优化 空间 ， 我 们 也 可 将 其 切 分 并 通过 事件 循环 分 派 到 不 同 回调 函 
数 里 。 稍 后 我 们 会 具体 介绍 一 下 这 种 方法 。 

口 创建 一 个 后 台 服 务 “你 能 想象 一 个 专门 用 于 计算 斐 波 那 契 数 的 后 台 服 务 器 吗 ? 好 吧 ， 或 
许 不 能 ， 但 是 这 确实 是 非常 普遍 的 将 前 台 服 务 转移 到 后 台 执 行 的 方法 ， 我 们 会 在 这 章 的 
最 后 介绍 如 何 实现 一 个 后 台 运 行 的 数学 计算 服务 器 。 这 个 请 求 处 理 函 数 应 可 以 异步 地 调 
用 数据 服务 或 者 数据 库 、 收 集 响 应 数据 ， 然 后 发 送 给 浏览 器 。 

我 们 可 以 对 斐 波 那 契 算法 进行 优化 , 但 我 们 不 这 样 做 , 而 是 将 其 从 一 个 同步 的 函数 转换 成 一 
个 含有 对 应 回调 的 异步 函数 。 在 这 里 使 用 异步 的 斐 波 那 契 算 法 并 不 是 一 个 很 好 的 选择 , 但 它 的 确 
展示 了 算法 重 构 方法 。 我 们 选择 了 对 计算 过 程 进行 拆 分 , 并 通过 事件 循环 分 派 给 对 应 的 回调 函数 。 

首先 ,我 们 要 对 斐 波 那 契 函数 进行 实例 化 ,用 实例 化 后 的 对 象 取 代 原 来 实现 的 函数 。 如 果 已 
经 写 了 一 个 比较 原始 又 低 效 的 函数 , 之 后 你 可 能 不 得 不 用 一 个 更 好 的 替换 它 。 接 下 来 在 math .js 
中 添加 如 下 代码 : 


Var fibonacciAsync = exports.fibonacciAsync = function(n, done) { 

if (n === 1 || n === 2) 

done (1) ; 
else { 

process.nextTick (function() { 

fibonacciAsync (n-1, function(vall) { 
process.nextTick (function() { 
fibonacciAsync (n-2, function(val2) { 
done (vall+val2); 
























































这 就 是 我 们 的 新 的 异步 斐 波 那 契 算 法 。 我 们 已 经 把 它 从 一 个 简单 的 函数 转换 成 一 个 异步 驱动 
的 计算 函数 ， 这 样 就 可 以 通过 回调 函数 传递 结果 ， 如 下 所 示 : 
fibonacciAsync(n, function(value) { 


// 操作 值 
3} 


我 们 使 用 了 process .nextTick 方 法 将 一 个 递归 函数 转换 成 各 个 步 又 都 由 事件 循环 分 派 ,这 
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个 函数 通过 事件 循环 调用 回调 函数 , 确保 函数 能 快速 进入 事件 循环 , 这 样 服务 器 才能 继续 处 理 别 
的 HTTP 请 求 。 这 不 是 唯一 一 个 通过 事件 循环 派发 算法 步骤 的 方式 。 异 步 模块 也 可 以 做 这 个 ， 它 














有 一 系列 方法 帮助 实现 异步 的 JavaScript。 


在 fibonacciAsync 了 水 数 里 ，process .nextTick 方 法 替换 了 原始 算法 里 的 这 一 表达 式 : 


return fibonacci (n-1)+fibonacci (n-2); 








这 名 代码 的 任务 是 计算 两 个 斐 波 那 契 数 ， 然 后 对 其 执行 加 法 ， 最 后 将 结果 返回 给 调用 冰 数 。 
新 的 算法 有 3 个 异步 函数 来 实现 任务 的 各 个 步骤 ,并 使 用 了 process .nextTick 方 法 确保 这 些 都 





通过 事件 循环 分 派 执行 。 


在 我 们 介绍 后 面 的 内 容 之 前 ， 先 花 点 时 间 划 酌 下 这 个 方案 。 





它 没有 减少 必需 的 计算 量 , 只 是 








将 计算 过 程 交 给 事件 循环 调度 。 它 会 使 当前 的 Node 进 程 占 用 所 有 CPU 负载 , 这 绝 不 是 重 构 计算 密 
集 型 算法 〈 如 斐 波 那 契 算 法 ) 的 最 佳 途径 。 但 是 这 展示 了 通过 事件 循环 分 派 工作 的 技术 ， 这 个 技 
































术 对 一 些 算法 来 说 是 非常 实用 的 ， 但 是 对 其 他 算法 就 并 不 是 那么 实用 。 








这 个 技术 是 否 实用 还 是 取决 于 你 和 你 使 用 的 算法 , 你 需要 选择 


最 佳 的 方法 来 处 理 长 时 间 运 行 





的 计算 。 例 如 ， 这 章 的 后 面部 分 ， 我 们 会 展示 如 何 实现 一 个 可 以 用 HTTP 访 问 的 后 台 服 务 器 ， 这 





项 技术 可 以 将 计算 任务 推送 到 任何 模块 。 





创建 一 个 新 文件 fijbo2-node.js, 然 后 将 app-node .js 修改 为 require('./fibo2-nogde')， 
这 样 就 可 以 使 用 新 的 斐 波 那 契 模块 了 。 我 们 已 经 将 这 行 代码 添加 到 app-noqe .js 文件 里 , 不 过 
它 被 注释 掉 了 。 接 下 来 我 们 可 以 切换 代码 的 注释 来 改变 斐 波 那 契 算法 的 实现 : 





var htutil = require('./htutil'); 
Var math = require('./math'); 
function sendResult (req, res, a, fiboval) { 
res.writeHead(200, { 
'Content-Type': 'text/html' 
ye 
zes .end ( 
htutil.page("Fibonacci"，htutil.navbar()，[ 
(!isNaN(fiboval) ? 


("<p class='result'>fibonacci {a} = {fibo}</p>" 


.replace("{a}", a) 
.replace("{fibo}", fiboval)) 
Wm 


"<p>Enter a number to see its fibonacci</p>", 


"<form name='fibonacci' action='/fibonacci' method='get'>", 


"A: <input type='text' name='a' />", 
"</form>" 
] .join('\n')) 
yr: 
} 


exports.get = function(req, res) { 
if (!isNaN(req.a)) { 


math.fibonacciAsync (Math.floor(req.a), function(val) { 


sendResult (req, res, Math.floor(req.a), val); 


J 
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} else { 
sendResult (req, res, NaN, NaN); 
} 
} 
我 们 已 经 通过 将 运算 转移 到 sengdResult 函数 重 构 了 翡 波 那 契 模块 ， 我 们 以 两 种 方式 调用 
send Result， 并 依据 是 否 需要 显示 斐 波 那 契 数 判断 以 哪 种 方式 调用 。 
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虽然 请 求 较 大 的 辈 波 那 契 数 依然 需要 很 长 的 时 间 来 计算 , 但 是 服务 器 不 会 阻塞 , 可 以 处 理 其 
他 请 求 。 当 打开 多 个 浏览 器 标签 页 的 时 候 ， 你 就 会 明显 感觉 到 这 点 。 在 一 个 标签 页 中 请 求 一 个 大 
的 斐 波 那 契 数 会 需要 很 长 的 时 间 来 计算 。 然 后 在 另 一 个 标签 页 中 发 起 一 个 请 求 ， 就 像 你 在 截图 里 
看 到 的 ， 浏 览 咒 不 是 处 于 无 响应 状态 ， 而 是 在 顺利 地 处 理 请 求 。 











4.2.7 ”还 缺 什么 功能 


在 后 面 讨 论 Connect 时 , 我 们 会 发 现 Math Wizard 里 极 小 的 dispatch 函 数 做 的 事情 和 实际 Web 
服务 器 做 的 相 比 要 少 一 些 。 仅 仅 实 现 HTTP 协 议 并 不 能 造就 一 个 完善 的 Web 服 务 器 或 者 Web 应 用 ， 
为 它 缺 失 了 很 多 近 20 年 Web 应 用 开发 中 积累 下 的 最 佳 实践 。 

口 Math Wizard 不 能 关注 请 求 的 方式 (GET、PUT、POST 等 )。 要 维持 HTTP 的 语义 就 需要 对 
GET、PUT 或 者 PosT 请 求 进 行 不 同 的 处 理 。 

口 没有 给 错误 的 URL 请 求 提 供 404 页 面 。 

口 没有 为 URL 和 表单 屏蔽 注入 式 的 脚本 攻击 。 

口 不 支持 cookie 处 理 ， 也 没有 使 用 cookie 维 持 会 话 。 

口 不 记录 请 求 。 

口 不 支持 身份 验证 。 

口 不 处 理 图 像 、CSS 、JavaScript 或 者 HTML 这 样 的 静态 文件 。 
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口 没有 对 页 面 尺寸 、 执 行 时 间 等 施加 限制 。 
就 像 我 们 将 在 介绍 Connect 和 Express 时 看 到 的 那样 ，Node 的 Web 框 架 弥 补 了 大 部 分 丢失 的 


特性 。 





4.2.8 使 用 Connect 框架 实现 Math Wizard 




















Connect ( http://senchalabs.github.com/connect/ ) 其 实 不 是 一 个 真正 意义 上 的 Web 框 架 ， 而 是 
Node 的 一 个 中 间 件 "框架 。 它 含有 11 个 已 绑 定 的 中 间 件 并 具有 丰富 的 第 三 方 中 间 件 以 供 选择 。“ 中 
间 件 ”这 个 术语 或 许 会 因为 太 过 笼统 让 你 感到 困惑 ， 因 此 接 下 来 我 们 对 这 个 词 进行 详细 介绍 。 

TJ Holowaychuck 将 “中 间 件 ”描述 为 易于 挂 载 和 调用 的 模块 ， 可 以 “无 序 ” 使 用 并 为 应 用 
的 快速 开发 提供 常用 的 功能 ， 比 如 请 求 的 路 由 选择 、 身 份 验证 、 请 求 记录 、cookie 处 理 等 ( 详 见 
http://tjholowaychuk.com/post/664516126/connect-middleware-for-nodejs )。 

中 间 件 有 以 下 两 种 形式 。 

口 过 滤器 ”处 在 中 间 层 负责 处 理 传人 和 传 出 的 请 求 ， 但 是 本 身 不 响应 请 求 。 过 滤器 的 一 个 

例子 就 是 中 间 件 /ogger， 它 专门 提供 可 定制 的 信息 记录 。 

口 供应 者 “作为 堆栈 的 终端 ， 意 味 着 一 个 进入 的 请 求 最 后 会 在 供应 者 处 处 理 ， 并 且 供 应 者 
负责 发 送 响 应 。 供 应 者 的 一 个 例子 就 是 为 静态 文件 服务 的 中 间 件 static。 

在 前 面 一 人 节 ， 我 们 看 到 了 一 个 以 http.createServezr 对 象 和 一 个 函数 构建 的 应 用 ， 这 个 函 
数 会 在 每 一 个 HTTP 请 求 到 达 服 务 器 的 时 候 被 调用 。 在 使 用 Connect 的 时 候 ， 你 就 只 需要 用 到 
connect .createServer 对 象 ， 然 后 将 中 间 件 模块 绑 定 到 服务 器 上 。 作 为 中 间 件 模块 之 一 ， 
router 模 块 用 于 实现 应 用 的 URL。 

了 解 这 些 内 容 之 后 ， 我 们 可 以 开始 看 一 些 代码 了 。 
















































































4.2.9 安装 和 设置 Connect 
首先 ， 确 保 Connect 已 经 安装 好 了 : 


$ npm install connect 
然后 创建 app-connect .js 文件 ,使 其 内 容 如 下 : 


Var connect 
var htutil 


= require('connect'); 
= require('./htutil'); 
connect .createServer () 

.usSe (connect .favicon()) 

.UsSe (connect .logger () ) 


.use('/filez', connect.static(_ dirname + '/filez')) 
.Use (connect .router (function(app)t{ 
app.get ('/', 


require('./home-node') .get); 




















Q@ 中 间 件 是 一 种 独立 的 系统 软件 或 服务 程序 ， 分 布 式 应 用 软件 借助 这 种 软件 在 不 同 的 技术 之 间 共享 资源 。 
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app.get('/square', htutil.loadParams, 
require('./square-node') .get); 

app.get ('/factorial', htutil.loadParams, 
require('./factorial-node') .get); 

app.get ('/fibonacci', htutil.loadParams, 
require('./fibo2-node') .get); 

app.get ('/mult', htutil.loadParams, 
require('./mult-node') .get); 

})) .listen(8124); 
console.log('listening to http://localhost:8124'); 


然后 按照 下 面 的 方式 启动 服务 需 : 

$ node app-connect .js 

因为 服务 器 监 折 了 8124 端 口 ， 所 以 直接 在 浏览 器 里 访问 http://localhost:8124/ 即 可 使 用 它 。 

恭喜 ! 我 们 现在 已 经 成 功 运行 了 第 一 个 基于 Connect 开 发 的 Node 应 用 。 

你 会 发 现 它 看 起 来 ( 及 其 行为 ) 和 之 前 的 Math Wizard 很 类 似 ， 这 是 因为 app-connect .js 
模块 重用 了 app-nodae .js 的 模块 。app ,get 函数 所 做 的 只 是 把 请 求 转 发 到 一 个 已 存在 的 模块 。 

如 果 行 为 类 似 的 话 ， 那 么 Connect 带 来 的 优势 在 哪里 呢 ? 

不 同 点 在 于 Connect 提 供 了 一 个 请 求 处 理 和 调度 框架 来 减轻 应 用 开发 的 压力 。 它 会 帮 你 处 理 
之 前 缺失 的 作为 一 个 “完备 Web 服 务 器 ”应 该 有 的 特性 ， 让 你 把 精力 更 多 的 放 在 自己 的 应 用 上 。 
但 是 这 足以 让 Connect 成 为 一 个 应 用 框架 吗 ? 

Connect 没 有 以 一 个 应 用 框架 的 形式 呈现 出 来 ， 而 是 作为 一 个 应 用 框架 的 构建 基石 存在 。 
Express 就 是 一 个 建立 在 Connect 之 上 的 框架 。 Connect 本 身 是 非常 实用 的 , 了 解 Connect 有 助 于 理解 
Express， 所 以 接 下 来 我 们 会 简单 介绍 下 Connect， 然 后 再 介绍 Express。 






































4.2.10 使 用 Connect 


我 们 已 经 学 习 了 一 部 分 有 关 Connect 的 知识 , 接 下 来 看 一 些 更 详细 的 内 容 。Connect 是 Express 
框架 的 基础 , 它 几 乎 突破 了 所 有 之 前 讨论 过 的 基于 HTTP 服 务 器 对 象 构建 应 用 的 限制 。 不 要 着 急 ， 
我 们 先 看 一 下 app-connect .js。 

在 Connect 里 有 很 多 配置 服务 器 对 象 的 方式 。 我 们 在 app-connect .js 里 是 这 么 做 的 : 


Var connect = Tedquire('connect ' ) ; 
connect .createServer () 
.use (connect .favicon()) 
.USe (connect .logger()) 
.use('/filez', connect.static(_ dirname + '/filez')) 
.usSe (connect .router (function(app)t 
// 配置 路 由 器 


})).listen( .. port number ..); 
.use 方 法 可 用 于 绑 定 中 间 件 到 Connect 服 务 器 。 它 会 配置 一 系列 在 接 到 请 求 时 调用 的 中 间 件 
模块 。 当 然 ， 你 的 应 用 决定 了 使 用 哪些 中 间 件 模块 。 
.use 方 法 允许 我 们 链 式 调用 .use 从 而 获得 更 好 的 编程 体验 ( server.use() .use() .use(). 


use() )。 
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在 这 个 例子 里 我 们 要 配置 的 中 间 件 有 favicon、logger、static 和 router。 

在 创建 一 个 Apache 式 访问 记录 时 , logger 中 间 件 非常 有 用 。 默认 情况 下 ,logger 会 将 数据 输出 
到 控制 台 上 ,但 是 也 可 以 通过 配置 以 其 他 任何 格式 输出 或 者 记录 到 任意 文件 里 。 

static 中 间 件 实现 一 个 “静态 Web 服 务 器 ”来 传递 存放 在 特定 目录 下 的 文件 。 这 意味 着 如 果 你 
有 一 个 目录 ， 其 中 包含 了 要 发 送 给 浏览 器 的 .html，.css 或 者 .js 文件 ，connect .static 中 间 件 可 
以 帮 你 完成 任务 。 

favicon 是 一 些 浏 览 咒 在 地 址 栏 、 标 签 栏 显示 的 小 图 片 ,， 这 些小 图 片 也 是 一 个 你 的 品牌 存在 
的 标志 ，favicon 中 间 件 会 帮助 处 理 这 些 图 片 。 

router 中 间 件 用 于 将 每 一 个 URL 请 求 正确 传递 到 对 应 的 处 理 函 数 。 配 置 方法 如 下 : 


.usSe (connect .router (function(app)t{ 
// 配置 路 由 器 
} 


但 是 真正 占 主 导 地 位 的 是 路 由 器 的 配置 代码 ， 在 配置 代码 处 你 可 以 声明 应 用 要 识别 的 URL， 
还 有 每 一 个 URL 对 应 的 处 理 函 数 。router 的 配置 形式 如 下 : 

app.requestName('path', functionl(reqg, res, next) {..}); 

请 求 名 指 的 是 指 HTTP 动 作 ， 比 如 get 、put 、post 等 。 这 意味 着 你 可 以 在 页 面 上 设置 一 个 
HTML 表 单 ， 将 method 设 置 为 PpST， 然 后 用 app.get 函数 将 页 面 传递 给 浏览 器 ， 然 后 使 用 
app .post 函 数 来 接收 表单 传递 回 的 数据 。 我 们 会 在 第 6 章 看 到 对 应 的 例子 , 不 过 它 看 起 来 更 像 下 
面 定义 的 函数 : 

app.get ('/form', createPageWithForm); 

app.post('/form', receiveValuesPostedWithForm); 


上 面 例子 里 的 回调 函数 比 一 般 的 请 求 处 理 函 数 多 了 一 个 函数 类 型 的 参数 。 它 的 定义 形式 是 
function(red，res，next)，red 和 res 分 别 对 应 了 HTTP 请 求 数据 和 HTTP 响 应 数据 。next 
这 个 参数 对 应 的 是 Connect 提 供 的 函数 ， 用 于 确保 所 有 的 中 间 件 函数 已 经 执行 。 

就 像 我 们 在 app-connect .js 里 做 的 那样 ， 路 由 可 以 分 配 到 多 个 函数 中 。 只 要 使 用 了 next 
函数 ，Connect 就 可 以 依次 对 函数 进行 调用 。 和 app-node . js 里 一 样 ， 我 们 在 app-connect .js 
里 使 用 的 也 是 ntuti1.1oadParams 了 水 数 。 你 应 该 还 记得 ， 它 使 用 了 Connect 提 供 的 next 函数。 

这 是 一 个 典型 的 路 由 器 配置 函数 : 

app.get ('/square', htutil.loadParams, 

require('./square-node') .get); 

这 个 函数 的 参数 是 一 个 URL 字 符 串 和 两 个 函数 类 型 的 参数 ， 第 一 个 是 ntutil.1oad- 
Params 了 荫 数 。 路 由 咒 配 置 函数 可 以 包含 不 限 数量 的 函数 ， 你 可 以 为 自己 的 应 用 构造 一 个 处 理 
函数 队列 。 

总 而 言 之 , 中 间 件 和 多 个 路 由 器 函数 组 成 了 一 种 处 理 HTTP 请 求 的 状态 机 。 我 们 已 经 看 到 了 
两 个 函数 列 。 第 一 个 是 列 在 服务 费 配 置 中 的 中 间 件 函数 ， 还 有 就 是 我 们 刚刚 看 到 的 路 由 器 函数 
列表 。 


























































































































4.3 使 用 Express 框架 实现 Math Wizard 55 





4.3 使 用 Express 框架 实现 Math Wizard 


现在 我 们 已 经 对 Connect 有 所 了 解 ， 接 下 来 用 Express 对 Math Wizard 进 行 改 进 。Express 是 一 个 
基于 Connect (一 个 中 间 件 框架 ) 的 Web 应 用 框架 。 这 意味 着 Express 专 注 于 构建 一 个 应 用 ， 包 括 
提供 一 个 模板 系统 ， 而 Connect 专 注 于 做 Web 服 务 的 基础 设施 。Express 和 Connect 是 由 同一 个 团队 
开发 的 ， 所 以 它们 的 API 相 似 度 比 较 高 。 

例如 ， 这 是 用 Express 实 现 的 一 个 Hello World 示 例 : 

Var app = require('express') .createServer(); 

app.get('/', function(req, res) { 

res.send('Hello, world!'); 

下 

app.listen(3000); 

这 个 例子 看 起 来 和 前 面 一 节 的 代码 比较 类 似 。 然 而 ，createServer 返 回 的 对 象 中 包含 被 绑 
定 的 路 由 器 中 间 件 函数 。 看 起 来 你 似乎 跳 过 了 大 部 分 中 间 件 的 绑 定 和 配置 , 直接 使 用 了 URL 路 由 
器 。 当 然 ， 你 还 可 以 继续 绑 定 和 配置 中 间 件 : 

Var express = require('express'); 

Var app = express.createServer! 

express.logger (), 


express.bodyParser() 


六 
安装 Express 和 EJS ( 模板 处 理 系统 ) 只 需要 做 下 面 的 操作 : 


$ npm install express ejs 

qs@0.1.0 ../node modules/express/node modules/qs 
express@2.3.11 ../node modules/express 

ejs@0.4.2 ../node modules/ejs 























4.3.1 准备 工作 
必需 的 模块 安装 好 后 ， 我 们 可 以 写 代 码 了 。 不 过 需要 先 做 点 准备 工作 ， 创 建 一 个 目录 : 


$ mkdir views 


然后 创建 app-express .js， 使 其 包含 下 面 的 代码 : 





Var htutil = require('./htutil'); 
Var math = require('./math'); 
Var express = require('express'); 


Var app = express.createServer!( 
express.1logger () 


) 


app.register('.html', require('ejs')); 
// 可 选 ， 因 为 Express 下 上 默认 为 CWD/vViews 
app.set('views'，_ dirname + '/views'); 
app.set('view engine', 'ejs'); 
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app.configure (function()t 
app.use(app.router); 
app.use (express.static(_ _ dirname + '/filez')); 
app.use (express.errorHandler({ 
dumpExceptions: true, showStack: true })); 
上 


我 们 启动 了 服务 器 ， 然 后 配置 了 必需 的 中 间 件 。 细 节 上 会 有 一 些 区 别 ， 例 如 我 们 使 用 了 
express .1logger 而 不 是 connect .1ogger， 不 过 看 起 来 还 是 很 类 似 。 

新 用 到 的 方法 有 app .register 和 app.set。 因 为 这 里 展示 的 配置 项 对 应 的 是 模板 系统 的 配 
置 ， 所 以 .html 文 件 会 由 EJS3 引 擎 处 理 。 过 会 儿 我 们 会 看 到 res .render 如 何 通 过 模板 引擎 将 数据 
呈现 到 模板 里 。 

现在 看 下 路 由 器 配置 (依旧 在 app-express .js 中 进行 ): 


app.get ('/', function(req, res) { 
res.render('home.html', { title: "Math Wizard" }); 
这 
app.get ('/mult', htutil.loadParams, function(req, res) { 
if (req.a && req.b) req.result = req.a * reqg.b; 
res.render('mult.html', { 
title: "Math Wizard" , req: req }); 
J 
app.get ('/square', htutil.loadParams, functionl(req, res) { 
if (req.a) reqgq.result = req.a * req.a; 
res.render('square.html', { 
title: "Math Wizard" , req: req }); 
je 
app.get ('/fibonacci', htutil.loadParams, function(req, res) { 
If (req.a) { 
math.fibonacciAsync (Math.floor(regq.a), function(val) { 
req.result = val; 


res.render('fibo.html', { 
title: "Math Wizard" , req: req }); 
i 
} else { 
res.render('fibo.html', { 
title: "Math Wizard" , req: reqg }); 


} 
网 这 
app.get ('/factorial', htutil.loadParams, function(req, res) { 
if (req.a) req.result = math.factorial (req.a); 
res.render('factorial.html', { 
title: "Math Wizard" , req: reqg }); 
es 


app.get ('/404', function(req, res) { 
res.send('NOT FOUND '+req.url); 
3 


app.listen(8124); 
console.log('listening to http://localhost:8124'); 


4.3 使 用 Express 框架 实现 Math Wizard ”57 





除了 两 者 毫 不 相干 的 部 分 之 外 ，Express 里 的 路 由 器 配置 很 大 程度 上 和 Connect 一 样 。 就 像 之 
前 提示 过 的 ,路 由 器 函数 可 以 直接 作用 于 服务 器 对 象 。 最 主要 的 不 同 点 在 于 我 们 在 路 由 需 函 数 里 
依赖 了 模板 引擎 的 部 分 。 

在 Express 里 ,我 们 使 用 res .render 也 数 而 不 是 res .writeHead 或 者 res .end 来 发 送 页 面 。 
res .render 清 数 通 过 一 个 模板 文件 泻 染 数 据 ， 让 我 们 能 更 好 地 实现 数据 和 表现 的 分 离 。 

EJS 只 是 Express 里 众多 模板 引 苟 中 的 一 个 ,我 们 的 配置 目的 就 是 让 EJS 能 够 为 views 目 录 下 的 
所 有 .html 文 件 服务 。 

Express 里 还 有 其 他 一 些 模 板 引 擎 ， 而 文件 后 级 可 以 用 于 指定 对 应 的 模板 引擎， 如 下 所 示 : 



































res.render('index.haml'，{..data..}); // 使 用 Haml 
res.render('index.jade'，{..data..}); // 使 用 Jade 
res.render('index.ejs'， {..data..}); // 使 用 EJS 
res.render('index.coffee', {..data..}); // 使 用 CoffeeKup 
res.render('index.jqtpl'，{..data..}); // 使 用 jQueryTemplates 





你 也 可 以 通过 app . set 方 法 改变 默认 的 演 染 引擎 : 











app.set('view engine'，'haml'); // 使 用 Haml 
app.set('view engine'，'jade'); // 使 用 Jade 
app.set('view engine'，'ejs'); // 使 用 EJS 


我 们 已 经 讨论 过 代码 的 具体 实现 ， 接 下 来 可 以 创建 模板 文件 了 。 所 有 的 模板 文件 都 要 放 到 
views 目 录 下 。 
首先 ， 在 layout .html 里 ， 我 们 添加 如 下 代码 : 





<html> 
<head><title><%= title %></title></head> 
<body> 
<h1><g= title %></hl> 
<table> 
tbo 
<div class='navbar'> 
<p><a href='/'>home</a></p> 
<p><a href='/mult'>Multiplication</a></p> 
<p><a href='/square'>Square's</a></p> 
<p><a href='/factorial'>Factorial's</a></p> 
<p><a href='/fibonacci'>Fibonacci's</a></p> 
</div> 
/tds 
<td><%$- body %></td> 
/臣下 5 


</table></body></html> 
Express 里 的 layout 模 板 比 较 特 殊 。 注 意 ， 在 app .js 里 我 们 使 用 了 res .render ('fipbo. 
html' . . ) 而 没有 提 到 layout .html。 这 是 为 什么 呢 ?” 默 认 情 况 下 ,模板 中 用 于 演 染 的 内 容 会 被 
命名 为 body ， 然 后 传递 到 1ayout 模 板 中 。 当 app .js 调用 res .render('fibo.html'..) 时 ， 
它 会 先 用 fibo .ntml 泻 染 对 应 的 页 面 片 段 ， 然 后 青 使 用 1ayout 模 板 演 染 整 个 页 面 。 
现在 有 两 种 方法 覆盖 这 一 默认 的 行为 。 第 一 种 是 在 Express 里 创建 一 个 全 局 的 配置 , 通过 这 个 
全 局 配置 来 控制 layout 模 板 的 启用 与 禁用 。 
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app.set('view options', { layout: false (or true) }) 
第 二 种 方法 是 履 盖 1ayout 模 板 对 应 的 泻 染 方式 : 
res.render('myview.ejs', { layout: false (or true) }); 


我 们 可 以 在 一 个 特定 的 浑 染 过 程 中 关闭 或 者 启用 layout 模 板 ， 或 者 通过 下 述 代码 使 用 不 同 
的 layout 模 板 : 

res.render('page', { layout: 'mylayout.jade' });} 

EJS 模 板 大 部 分 基于 HTML 规 范 ， 而 3 种 特别 的 标签 除外 。 如 果 你 使 用 过 其 他 模板 系统 ， 应 该 
很 熟悉 这 些 标签 ， 如 下 所 示 : 
口 用 <% code %> 表 示 用 于 控制 逻辑 的 不 被 缓存 的 代码 ; 
口 用 <s= coge %> 表 示 使 用 默认 转 义 的 html 代 码 ; 
口 用 <s- code %> 表示 未 转 义 的 被 缓存 代码 。 

我 们 可 以 在 例子 里 看 到 使 用 <s= title %> 标 签 代表 已 转 义 的 HTML, 使 用 <%- body %> 
标签 表示 的 不 需要 缓存 的 数据 。 

接 下 来 让 我 们 回 到 Math Wizard 模 板 home .html: 


<p>Math Wizard</p> 
home .html 模 板 含有 的 内 容 就 是 上 面 这 部 分 。 
在 mult .html 里 我 们 添加 下 面 的 代码 : 


<% if (req.a && req.b) { 各 > 
<p class='result'> 
< 外 = req.a $> * <%$= req.b %> = < 区 = req.result 和 > 
</p> 
< 外 } %> 
<p>Enter numbers to multiply</p> 
<form name='mult' action='/mult' method='get'> 
A: <input type='text' name='a' /><br/> 
B: <input type='text' name='b' /> 
<input type='submit' value='Submit' /> 
</form> 


在 这 里 我 们 使 用 <s code %> 来 介绍 通过 条 件 语句 控制 泻 染 的 方式 : 


<% if (req.a && req.b) { 各 > 
conditional content 
<%$ } %$> 


<$ code %> 标 签 里 的 代码 就 是 JavaScript 代 码 ， 可 以 做 任何 JavaScript 可 以 做 的 事 ， 不 过 在 这 
个 例子 里 我 们 只 是 在 条 件 满足 的 情况 下 渲染 一 些 内 容 。 如 果 要 使 用 一 个 数据 列表 或 者 数组 , 你 可 
以 使 用 while 语 句 遍 历 和 演 染 数据 项 。 

现在 ， 我 们 在 square .html 里 添加 下 面 的 代码 : 


< 多 if (req.a) { %> 
<p class='result'> 
<g = req.a g> squared = <%= req.result %> 
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必 六 和 

< 外 } %> 

<p>Enter numbers to multiply</p> 

<form name='square' action='/square' method='get'> 
A: <input type='text' name='a' /> 
<input type='submit' value='Submit' /> 

</form> 


现在 在 factorial.html 里 添加 下 面 的 代码 : 


< 多 if (req.a) { 各 > 

<p class='result'> 

<%$= req.a %> factorial = <%= req.result %> 

必 关 入 溉 

< 外 } %> 

<p>Enter a number to see it's factorial</p> 

<form name='factorial' action='/factorial' method='get'> 

A: <input type='text' name='a' /> 

<input type='submit' value='Submit' /> 
</form> 


最 后 ， 在 fibo.html 里 添加 下 面 的 代码 : 


< 和 if (req.a) { 和 > 
<p class='result'> 
fibonacci <%= req.a %> = <%= req.result %> 
/D> 
< 外 } %> 
<p>Enter a number to see it's fibonacci</p> 
<form name='fibonacci' action='/fibonacci' method='get'> 
A: <input type='text' name='a' /> 
<input type='submit' value='Submit' /> 
</form> 


现在 ,一 切 都 准备 就 绕 ， 你 可 以 使 用 下 面 的 命令 运行 你 的 应 用 了 : 
$ node app-express.js 


现在 请 用 浏览 避 访 问 http://localhost:8124/， 享 受 成 果 吧 。 





4.3.2 ”人 处理 错误 


错误 是 不 可 避免 的 。 因 为 提前 对 错误 进行 检测 会 减少 修复 错误 的 工作 量 , 所 以 我 们 最 好 能 
先 对 错误 有 所 了 解 。Express 提 供 了 两 种 捕获 错误 的 方式 。 
在 Math Wizard 应 用 里 我 们 有 这 样 一 行 代码 : 


app.use (express.errorHandler({ 
dumpExceptions: true, showStack: true 
站 汪 


这 是 默认 的 错误 处 理 函 数 , 展示 了 一 个 对 高 手 和 普通 开发 者 都 很 友好 的 栈 轨 迹 。 你 不 会 希望 
把 这 些 内 容 直 接 展 示 给 用 户 的 。 取 而 代 之 的 是 , 你 会 想 使 用 类 似 一 群 鸟 把 鲸鱼 拖 出 水 面 那样 的 内 
容 来 展示 。 要 展示 用 户 友好 的 错误 , 首先 要 使 用 app .error 函 数 安装 一 个 错误 事件 处 理 函 数 。 注 
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省 


， 它 所 调用 的 函数 有 一 个 可 选 的 参数 err ， 用 于 存放 错误 对 象 。 
app.error (functionl(err, req, res, next) { 


res.send(... error page); // or res.render('template'..) 


上 
一 个 有 趣 的 错误 页 面 可 以 很 好 地 展示 你 的 才华 , 当然 你 也 可 以 创建 一 个 无 趣 且 乏 味 的 错误 页 
面 。 这 些 都 取决 于 你 自己 。 


4.3.3 ”参数 化 的 URL 和 数据 服务 


到 现在 为 止 ,我 们 已 经 探索 过 能 发 送 HTML 到 浏览 器 的 应 用 。 虽 然 这 是 一 个 比较 重要 的 使 用 
场景 , 但 是 Express ( 及 Connect ) 还 可 以 用 来 做 更 多 的 事情 。 例 如 , 我 们 通常 使 用 HTTP 构 建 REST 
服务 ， 用 于 发 送 数据 以 供 其 他 应 用 使 用 ， 而 不 是 发 送 给 用 户 HTML。 

再 早 一 点 的 时 候 , 我 们 考虑 ( 并 排除 ) 了 将 斐 波 那 契 计 算 从 前 台 服 务 器 转移 到 后 台 的 可 能 性 。 
接 下 来 继续 我 们 的 学 习 并 再 构建 一 个 应 用 ,来 看 如 何 实现 这 个 想法 。 同 时, 我们 也 会 关注 下 Express 
的 参数 化 路 由 选择 和 格式 化 响应 数据 的 特性 。 让 我 们 开始 吧 。 

1. Express 里 参数 化 的 URL 

Express 里 的 路 由 选择 系统 允许 你 在 URL 中 指定 req 对 象 可 以 识别 的 占 位 符 。 这样 你 的 应 用 会 
比 没有 参数 化 URL 的 应 用 更 加 灵活 。 整 个 过 程 是 通过 一 组 带 URL 标 识 符 的 类 型 匹配 来 完成 的 。 
Express 会 检查 请 求 的 URL， 进 行 类 型 匹配 ， 取 出 匹配 成 功 的 元 素 ， 然后 把 数据 填充 到 regq 对 象 的 
字段 里 。 

从 例子 上 看 会 更 清晰 一 些 : 

app.get ('/user/:id', function(req, res)t 


res.send('user ' + regq.params.id); 


1 

/user/ :id 这 样 的 URL 有 一 个 占 位 符 叫 做 ida。Express 会 识别 /user/ 后 的 内 容 ， 然 后 将 其 注 
册 到 req .params .id 字段 上 。 如 果 你 喜欢 ， 匹 配方 式 可 以 用 正则 表达 式 。 

2. 数学 计算 服务 器 (和 客户 端 ) 

现在 ， 我 们 创建 一 个 支持 数学 运算 的 服务 器 。 服 务 器 的 返回 结果 用 JSON 对 象 表示 。 它 一 样 
支持 前 面 Math Wizard 里 的 4 种 操作 。 

创建 一 个 math-server .js， 使 其 包含 下 面 的 代码 : 


Var math = require('./math'); 

var express = require('express'); 

Var app = express.createServer! 
//express.logger() 

入 

app.configure (function()t 
app.use(app.router); 
app.use (express.errorHandler({ 

dumpExceptions: true, showSstack: true })); 


Dy 
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app.get('/fibonacci/:n', function(req, res, next) { 
math.fibonacciAsync (Math.floor (regq.params.n), 
function(val) { 
res.send({ n: req.params.n, result: val }); 
过 
于 沙 这 
app.get ('/factorial/:n', function(req, res, next) { 
res.sendl({ 
n: req.params.n, 
result: math.factorial (Math.floor(req.params.n)) 
} 
网 这 
app.get ('/mult/:a/:b', function(req, res, next) { 
res.sendl({ 
a: regq.params.a, b: regq.params.b, 
result: regq.params.a * req.params.b 
网 有 
} 
app.get ('/square/:a', function(req, res, next) { 
res.send({ 
a: req.params.a, 
result: req.params.a * req.params.a 
J 
中 
app.listen(3002); 


上 面部 分 就 是 除了 数学 模块 之 外 的 整个 服务 器 ， 和 之 前 我 们 使 用 的 一 样 。 它 有 一 个 比较 简单 
的 配置 ， 通 过 监听 http://localhost:3002/ 使 其 作为 Math Wizard 的 后 台 程 序 。 

我 们 指定 的 路 由 是 很 简单 的 ， 作 用 仅仅 是 为 每 一 个 操作 需要 的 函数 参数 提供 存放 空间 。 

这 是 我 们 第 一 次 看 到 res . sendq 的 使 用 。 直 接 以 数组 形式 的 HTTP 报 头 信息 值 (特定 于 HTTP 
响应 报头 ) 和 HTTP 状 态 码 来 发 送 响应 数据 是 一 个 很 灵活 的 方式 。 它 在 这 里 自动 检测 对 象 ， 将 其 
格式 化 为 JSON 格 式 的 文本 ， 然 后 用 正确 的 Content-Type 发 送 。 

现在 让 我 们 运行 一 下 看 看 : 


$ node math-server.js & 

[1] 10483 

$ curl -f http://localhost:3002/square/34.2 
{"a":"34.2","result":1169.64} 

$ curl -上 http://localhost:3002/mult/3.3/3 
{"a:"3.3","b":"3","result":9.899999999999999} 
$ curl -f http://localhost:3002/factorial/20 
{"n":"20","result":2432902008176640000} 

$ curl -f http://localhost:3002/fibonacci/20 
{"n":"20","result":6765} 


现在 我 们 已 经 实现 了 服务 器 ， 那 么 客户 端 要 怎么 做 呢 ? 

因为 这 次 我 们 要 开发 的 是 HTTP 服 务 , 所 以 客户 端 程序 需要 创建 到 服务 器 的 HTTP 请 求 。 Node 
包含 了 一 个 非常 好 的 HTTP 客 户 端 对 象 ， 在 第 5 章 我 们 会 进行 深入 探讨 。 

我 们 的 任务 是 创建 一 个 HTTP 请 求 ， 发 送 请 求 ， 然 后 等 待 响 应 ， 将 响应 数据 进行 解码 ， 然 后 
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使 用 它 。 既 然 可 以 在 类 似 Math Wizard 这 样 的 Web 应 用 里 实现 这 一 任务 ,我 们 可 以 创建 一 个 简单 的 、 
对 应 数学 服务 器 的 客户 端 应 用 。 
创建 一 个 包含 下 面 代码 的 math .client . js 文件 : 





var http = require('http'); 
Var util = require('util'); 
[ 
"tibonacer/20", /factorLal/20"; 
"/mult/10/20", "/square/12" 
] .forEach (function(path) { 
Var req = http.request(t{ 
host: "localhost", 
port: 3002, 
path: path, 
method: 'GET' 
,， function(res) { 
res.on('data', function (chunk) { 

Util Log("BODY: "Chink) 

过 
必 
req.end(); 

J 


http.request 方 法 会 创建 一 个 HTTP 请 求 ， 并 将 URL 元 素 分 割 到 参数 对 象 中 。 对 此 ， 在 下 
一 章 的 内 容 里 ， 我 们 会 有 更 深入 的 探讨 ， 不 过 现在 你 需要 知道 res .on 语句 里 声明 的 回调 函数 会 
在 HTTP 响 应 数据 到 达 时 被 触发 。 

之 后 math-client.j s 会 创建 一 些 对 应 math-server. ] s 的 硬 编码 请 求 ， 输 出 如 下 的 内 容 : 











$ node math-client.js 

7 Jun 22:17:49 - BODY: ':"20","result":2432902008176640000} 
7 Jun 22:17:49 - BODY: ", "result":144} 
可 
7 


一 一 一 
a 
ID 


Jun 22:17:49 - BODY: "10","b":"20","result":200} 
Jun 22:17:49 - BODY: {"n":"20","result":6765} 


眼 尖 的 读者 可 能 会 注意 到 响应 数据 到 达 的 顺序 和 它们 在 数组 里 的 顺序 并 不 一 致 ,虽然 辈 波 那 
契 计 算 请 求 最 先 发 送 , 但 是 对 应 的 响应 却 最 后 达到 。 回 忆 下 ,回调 函数 的 异步 执行 以 它们 到 达 事 
件 循环 的 时 间 为 基础 ， 而 斐 波 那 契 函数 就 有 一 些 时 间 计 算 结果 。 事 实 上 ， 斐 波 那 契 函数 在 计算 第 
20 个 数字 的 序列 时 会 消耗 很 长 的 时 间 。 在 math-client .js 里 所 有 的 请 求 都 会 很 快 地 被 发 送出 
去 ， 因 为 它 本 身 发 送 请 求 的 工作 量 是 很 小 的 ， 而 我 们 看 到 的 输出 结果 来 自 处 理 函 数 *es .on 
人 server.js 里 的 请 求 是 交付 给 app . get 请 求 处 理 函 数 的 。 每 一 个 res .On 
('data' ..) 处 理 函 数 都 会 通过 套 接 字 ( 负责 发 送 HTTP 请 求 ) 和 一 个 app .get 请 求 处 理 函 数 绑 
定 。 每 当 app . get 请求 处 理 函 数 调用 res .send， 它 的 HTTP 响 应 会 反 过 来 让 res.on('data'..) 
处 理 函 数 等 待 响应 的 产生 。 

那么 , 是 什么 决定 了 输出 的 顺序 呢 ?” 其 实 是 math-server .js 用 来 计算 每 个 结果 所 消耗 的 时 
间 ， 因 为 结果 只 会 在 响应 到 达 时 才 被 输出 。 

大 部 分 情况 下 ， 计 算 〈 如 乘法 ) 的 速度 是 很 快 的 ， 服务器 能 很 快 返回 计算 结果 。 我们 之 前 讨 
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论 的 斐 波 那 契 查 询 里 的 问题 又 是 另外 一 回 事 了 。 因 为 fiponacciasync 的 使 用 , 斐 波 那 契 值 的 计 
算 会 与 运行 其 他 计算 并 行进 行 。 而 第 20 个 斐 波 那 契 数 的 计算 会 消耗 很 长 时 间 , 因此 其 他 先 计算 出 
的 值 会 首先 到 达 客 户 端 。 将 斐 波 那 契 请 求 的 值 改 为 2 会 缩短 计算 时 间 ,， 从 而 改变 响应 到 达 的 顺序 ， 
就 像 下 面 这 样 : 








$ node math-client.js 

7 Jun 22:34:49 - BODY: {"n":"2","result":1} 

7 Jun 22:34:49 - BODY: {"a"™:"10","b":"20","result":200} 

7 Jun 22:34:49 - BODY: {"n":"20","result":2432902008176640000} 
7 Jun 22:34:49 - BODY: {"a":"12","result":144} 


3. 使 用 数学 服务 器 重 构 Math Wizard 应 用 

现在 我 们 已 经 有 了 一 个 客户 端 函数 ， 将 它 移植 到 Math Wizard 里 的 请 求 处 理 函数 中 是 相当 容 
易 的 。 之 前 我 们 考虑 了 直接 面 对 用 户 的 服务 器 如 何 做 到 用 户 体 验 更 好 的 请 求 处 理 , 同时 又 能 处 理 
一 个 庞大 的 计算 。 斐 波 那 契 序 列 的 计算 就 是 一 个 大 型 计算 的 例子 , 如 果 放 到 用 户 直 接 面 对 的 服务 
器 上 计算 ， 肯 定 会 降低 用 户 使 用 时 的 愉悦 度 。 

我 们 之 前 的 解决 方案 是 通过 将 计算 切 分 成 多 块 的 方式 重 构 算 法 。 虽 然 这 个 方法 在 一 些 情况 下 
有 效 ， 但 是 面向 用 户 的 服务 器 依然 需要 进行 计算 ， 而 重 构 的 算法 可 能 更 低 效 。 在 使 用 
math-client.js 时 , 我 们 有 另 一 种 方式 来 解决 这 个 问题 ,即将 计算 工作 发 送 到 一 个 后 台 服 务 需 
或 者 使 用 负载 均衡 的 服务 器 集群 。 

在 app-express.js 里 ， 我 们 用 下 面 的 代码 替代 /fiponacci 请 求 处 理 函 数 : 


app.get ('/fibonacci', htutil.loadParams, function(req, res) { 
if (req.a) { 
Var httpreq = require('http') .request({ 
host: "localhost", 
Dorts 3002, 
path: "/fibonacci/"+Math.floor(req.a), 
method: 'GET' 
,， function(httpresp) { 
httpresp.on('data', function (chunk) { 
Var data = JSON.parse (chunk); 
req.result = data.result; 
res.render('fibo.html', 
{ title: "Math Wizard", req: req }); 
有 












































< 


J} 
httpreq.end(); 
//math.fibonacciAsync (Math.floor(regq.a), function(val) { 
//req.result = val; 
//res.render('fibo.html', 
//{ title: "Math Wizard" , req: req }); 
//}); 
} else { 
res.render('fibo.html', 
{ title: "Math Wizard" , req: req }); 
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新 的 请 求 处 理 函 数 会 回 过 头 来 从 我 们 刚刚 实现 的 后 台 服 务 器 (math-server.js ) 创建 一 个 
HTTP 请 求 。 实 际 上 这 是 你 可 以 想象 的 最 简单 的 REST 式 后 台 服 务 。 后 台 服 务 器 为 HTTP GET 请 求 
定义 了 一 些 URL， 它 会 返回 JSON 格 式 的 数据 ， 然 后 我 们 的 请 求 处 理 函 数 会 解析 JSON 数 据 来 获取 





结果 。 
在 修改 请 求 处 理 函数 后 ， 你 还 可 以 用 一 样 的 方式 运行 : 


$ node app-express.js 





这 就 好 像 在 使 用 fibonacciAsync, 结果 没有 变 , 那么 区 别 在 哪里 呢 ? 为 什么 要 用 后 台 服 务 
呢 ? 在 Math Wizard 里 ， 这 可 能 有 些 过 分 使 用 了 ， 但 是 它 证 明了 一 个 对 你 的 应 用 来 说 可 能 比较 完 




















美的 选择 。 下 面 给 出 一 些 理由 。 
口 最 好 把 繁重 的 计算 需求 从 直接 面 对 用 户 的 服务 需 移 除 ， 把 它 
口 用 负载 均衡 做 到 用 多 个 服务 器 处 理 请 求 〈 云 计算 )。 























度 的 途径 。 毕 竟 ， 为 什么 要 重新 运行 已 有 结果 的 计算 呢 ? 
口 它 可 以 让 你 通过 慷慨 陈 词 打动 你 的 老板 。 


























的 资源 留 给 与 浏览 需 交 互 。 


口 math-servez.js 的 响应 能 让 一 个 缓存 代理 的 使 用 变 成 一 个 非常 吸引 人 的 、 和 急剧 提 升 速 


这 个 方式 让 我 们 更 容易 地 实现 math-server.js 并 将 其 整合 到 Math Wizard 里 ， 它 证 明了 


Node 在 各 方面 带 来 的 简化 能 力 和 强大 功能 。 


4.4 小 结 





我 们 在 这 一 章 学 习 了 很 多 内 容 , 现在 可 以 准备 做 一 些 更 贴近 实际 的 应 用 了 。 下 面 移 回顾 一 下 


本 章 的 知识 : 
口 处 理 请 求 和 模块 化 管理 ; 





口 处 理 表单 提交 的 URL 查 询 参 数 ; 





口 使 用 异步 模块 编写 异步 代码 ; 
口 Connect 和 Express 为 一 个 完整 Web 应 用 提供 的 各 种 支持 ; 
口 Connect 作 为 中 间 件 的 价值 所 在 ; 
口 如 何 用 Connect 和 Express 路 由 规则 处 理 不 同 的 HTTP 动 作 ; 
口 在 Express 里 使 用 参数 化 的 URL; 
口 实现 一 个 REST 式 后 台 服 务 器 完成 负载 均衡 。 
到 现在 为 止 ， 我 们 已 经 学 习 了 很 多 与 实现 Web 应 用 相关 的 内 容 
客户 端 对 象 ， 以 及 Node 系 统 里 事件 的 分 配 进行 更 加 深入 的 探讨 。 











口 运行 时 间 很 长 的 计算 给 服务 絮 响 应 和 用 户 满意 度 之 来 的 影响 ， 


口 使 用 HTTP Server 对 象 ， 并 结合 Connect 和 Express 创 建 web 应 用 ; 


以 及 对 应 的 解决 方法 ; 


， 下 一 章 将 对 HTTP 服 务 吕 、 


简单 的 Web 服 务 器 、EVent- 
Emitter 和 和 HTTP 客户 端 











我 们 已 经 知道 了 如 何 使 用 Express 框 架 创建 Node 应 用 程序 , 接 下 来 将 深入 探索 HTTP Web 服 务 
顺 的 实现 细节 。 在 这 一 章 ， 我 们 将 实现 一 个 简易 的 Web 服 务 顺 ， 它 具备 真实 Web 服 务 器 的 功能 ， 


这 些 功 能 在 第 4 章 讨论 过 。 











HTTP 协 议 实 现 起 来 相当 复杂 ， 这 些 细节 最 好 还 是 交 给 Web 应 用 框架 去 做 。 既 然 如 此 ， 为 何 
还 要 实现 自己 的 HTTP Web 服 务 器 呢 ? 下 面 是 几 点 理由 : 





口 理解 如 何 选用 框架 ; 
口 理解 框架 的 设计 ; 
口 框架 不 能 满足 所 有 任务 的 需要 ; 














口 你 的 想法 比 框架 作者 更 高 明 。 
开始 吧 。 





口 需要 在 HTTP 层 直接 编码 实现 Web 服 务 ， 而 不 是 Web 应 用 ; 


5.1 通过 EventEmitter 发 送 和 接收 事件 
在 Node 应 用 中 ，EventEmitter 对 象 是 非常 关键 的 部 分 。 它 是 如 此 基础 ， 以 至 于 你 可 能 还 未 











察觉 到 它 的 存在 。Node 中 的 很 多 类 都 是 Event] 











Emitter 的 子 类 , 使 用 EventEmitter 的 方法 发 送 





事件 来 表示 一 些 状态 ,这些 事件 通过 Node 的 事件 循环 ， 最 终 触 发 回调 函数 。 


在 这 一 章 中 ， 我 们 将 使 用 HTTPServer 和 





HTTPCl1ient 类 ， 它 们 都 继承 自 EventEmitter， 








此 在 HTTP 协 议 的 每 一 步 , 它们 都 基于 EventEmitter 发 送 事 件 。 理解 EventEmitter 能 帮助 我 们 理解 


这 两 个 对 象 ， 以 及 Node 中 的 许多 其 他 对 象 。 





EventEmitter 被 定义 在 Node 的 事件 (events ) 模块 中 ,直接 使 用 EventEmitter 类 意味 着 














需要 先 声明 require('events') ,除非 使 用 场景 确实 需要 这 么 做 ,否则 不 必 显 式 声 明 
require('events')， 因 为 Node 中 很 多 对 象 都 无 需 你 调用 require('events') 就 会 使 用 





EventEmitter. 





下 面 的 例子 (pulser .js ) 直接 使 用 了 1 





事件 。 


Emitter 类 ， 它 会 告诉 我 们 如 何 发 送 和 接收 





Eventl 
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var events 
Va HELL 


= require('events'); 

= require('util'); 

function Pulser() { 
events.EventEmitter.call (this); 

} 


util.inherits(Pulser, events.EventEmitter); 


Pulser.prototype.start = function() { 
var self = this; 
this.id = setInterval (function() { 
util.log('>>>> pulse');} 
self.emit('pulse'); 
util.log('<<<< pulse');} 
}; L1000)s 
} 


例子 定义 了 一 个 类 Pulser， 该 类 (通过 util. inherits) 继承 自 EventEmitter。 它 的 
作用 是 每 隔 一 秒 钟 向 所 有 监听 器 发 送 一 个 定时 事件 ,start 方 法 使 用 了 setInterval 这 个 函数 来 
定期 ( 每 秒 钟 一 次 ) 重复 执行 回调 函数 ， 并 调用 emit 方 法 将 pulse 事 件 发 送 给 每 一 个 监听 器 。 
Pulser .js 的 大 部 分 代码 都 可 以 作为 一 个 独立 模块 ， 供 任何 需要 提供 定时 服务 的 应 用 使 用 。 
接 下 来 看 看 如 何 使 用 Pulser 对 象 : 


var pulser = new Pulser(); 
pulser.on('pulse', function() { 
util.log('pulse received'); 
的: 
pulser.start (); 


在 这 里 我 们 创建 了 一 个 Pulser 对 象 并 处 理 其 pulse 事 件 。 执 行 pulser.on('pulse'..) 为 



































pulse 事 件 和 回调 函数 建立 联系 。 然 后 这 段 代码 执行 start 方 法 让 整个 过 程 跑 起 来 。 





把 这 些 代 码 敲 完 后 保存 为 pulser.js， 然 后 运行 ， 你 就 可 以 看 到 如 下 的 输出 结果 : 


$ node pulser.js 

23 May 20:30:20 - >>>> pulse 

23 May 20:30:20 - pulse received 
<<<< pulse 
>>>> pulse 
pulse received 
<<<< pulse 





EventEmitter 原理 





EventEmitter 发 出 的 事件 都 有 和 名称， 比如 例子 中 用 到 的 pulse。 事 件 名 称 可 以 是 任何 有 意义 











的 词 ， 而 你 可 以 根据 需要 定义 多 个 事件 。 事件 名 称 可 以 通过 简单 地 调用 .emit 方 法 并 提供 事件 名 
来 设置 。 这 里 不 需要 注册 事件 名 那样 正式 的 操作 ， 调 用 .emit 方 法 就 够 了 。 按 照 惯例 ， 事 件 名 
error 用 于 表示 发 生 错 误 时 对 应 的 事件 。 

















对 象 使 用 . emit 函 数 发 送 事件 。 所 有 注册 到 对 应 事件 的 监听 器 都 可 以 收 到 事件 。 我 们 可 以 通 
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过 调用 .on 方法 注册 监听 器 ， 人 参数 是 事件 名 ， 并 用 一 个 回调 函数 接收 事件 。 

在 pulse. js 中 我 们 可 以 看 到 这 一 点 。Pulser 对 象 调 用 self.emit('pulse') 来 发 送 事件 ， 
稍 后 pulse.on('pulse'，..) 被 执行 并 用 于 接收 事件 。 

通常 来 说 ， 有 一 些 数据 需要 伴随 着 事件 同时 发 送 。 为 此 , 我 们 只 需 像 这 样 把 要 传递 的 数据 用 
作 .emit 执 行 时 的 参数 : 

self.emit ('eventName', datal, data2, ..); 
程序 会 接收 到 这 个 事件 ， 而 被 传递 的 数据 会 作为 回调 函数 的 参数 传人 , 下 面 的 代码 可 以 监听 
这 种 事件 : 

emitter.on('eventName', function(datal, data2, ..) { 


// 接收 到 事件 后 的 操作 
} 


从 下 一 节 起 ， 我 们 会 看 到 一 些 实际 应 用 时 的 例子 ( 使 用 HTTP 对 象 )，HTTP 客 户 端 对 象 和 服 
务 器 对 象 都 是 EventEmitter， 它 们 在 HITP 协 议 的 各 个 阶段 发 送 相应 的 事件 。 例 如 ， 每 个 到 来 
的 HTTP 请 求 都 被 封装 成 一 个 HTTP Reauest 对 象 ， 当 有 请 求 数据 到 达 时 ， 这 个 对 象 发 送 aata 事 
件 ， 并 在 所 有 数据 都 到 达 时 发 送 sna 事 件 ， 假 如 发 送 snq 事 件 之 前 套 接 字 连接 关闭 ， 它 将 发 送 
close 事 件 。 
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现在 让 我 们 使 用 HTTP 对 象 创建 一 个 实用 的 类 , 用 这 个 类 监听 HTTP 服 务 器 对 象 发 出 的 所 有 事 
件 。 该 类 可 以 做 一 个 实用 的 调试 工具 ， 也 演示 了 HTTP 服 务 器 对 象 的 工作 原理 。 

Node 中 的 HTTP 服 务 器 对 象 是 一 个 EventEmitter，HTTP Sniffer 所 做 的 只 是 监听 每 个 服务 器 事 
件 ， 然 后 输出 每 个 事件 的 相关 信息 。 

创建 一 个 名 为 httpsniffer .js 的 文件 ， 为 其 填 入 以 下 内 容 : 


Var util = require('util'); 











Var url = require('url'); 


exports.sniffOn = function(server) { 
server.on('request', function(req, res) { 
util.log('e_ request'); 
util.log(reqToString (req)); 
] 





server.on('close', function(errno) { 
util.log('e_close errno='+ errno); 


}); 


server.on('checkContinue', function(req, res) { 
util.log('e_ checkContinue'); 
util.log (reqToString (reG) ) ; 
res.writeContinue(); 


}); 
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server.on('upgrade', function(req, socket, head) { 
util.log('e upgrade'); 
util.log(reqToString (req)); 

i 


server.on('clientError', function() { 
util.log('e clientError'); 
}; 


// server.on('connection', ..)? 


} 


Var reqToString = function(req) { 
Var ret = 'request ' + reqgq.method +' '+ 
req.httpVersion +' '+ req.url +'\n'，; 
ret += JSON.stringify(url.parse(regq.url, true)) +'\n'; 
Var keys = Object.keys (regq.headers); 
for (var i = 0, 1 = keys.length; i < 1; i++) { 
var key = keys[i]; 
ret += i +' '+ key +': '+ req.headers[key] +'\n'，; 
} 
if (req.trailers) 
ret += req.trailers +'\n'; 
return ret; 
} 


exports.reqToString = reqToString; 


上 面 的 代码 比较 多 ， 关 键 部 分 是 sniffon 函 数 。 给 定 一 个 HTTP 服 务 器 函数 时 ， 它 使 用 .on 





方法 连接 监 昕 函数 ， 后 者 输出 HTTP 服 务 右 对 象 发 送 的 每 个 事件 的 相关 数据 。 此 对 象 的 事件 对 应 
HTTP 协 议 中 服务 器 与 客户 端 之 间 的 数据 交换 。 


了 ， 


的 小 


下 面 是 使 用 HTTP Sniffer 的 一 个 例子 ， 它 由 hello world 那 个 例子 (hwserver .js ) 修改 而 来 : 


var http = require('http'); 
Var sniffer = require('./httpsniffer'); 


Var server = http.createServer (function (req, res) { 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end('Hello, World!\n'); 

os 

sniffer.sniffOn(server); 

server.listen(3000); 


有 了 这 些 之 后 ， 运 行 该 服务 器 : 

$ node hwserver.js 

在 浏览 器 中 访问 http://localhost:3000/， 你 就 能 看 到 如 下 的 控制 台 输 出 。 注意 有 两 个 i 青 求 产 生 
一 个 对 应 / ， 男 一 个 对 应 /favicon.。favicon 就 是 一 个 显示 在 浏览 器 中 方便 标识 你 的 网 站 
图 标 。 此 刻 我 们 使 用 的 服务 器 还 不 支持 favicon， 稍 后 我 们 会 了 解 如 何 实现 它 。 


$ node hwserver.js 
6 Apr 21:14:38 - ee request 
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6 Apr 21:14:38 - request GET 1.1 / 
{"search":"","query":{},"pathname":"/","href":"/"} 

0 host: localhost:3000 

1 user-agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10 6 7; en-us) 
AppleWebKit/533.20.25 (KHTML, like Gecko) Version/5.0.4 Safari/533.20.27 
2 accept: application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8, 
image/png,*/*;q=0.5 

3 cache-control: max-age=0 

accept-language: en-us 

accept-encoding: gzip, deflate 

connection: keep-alive 


OU 心 


6 Apr 21:14:39 - e_redquest 

6 Apr 21:14:39 - request GET 1.1 /favicon.ico 
{"search":"","query":{},"pathname":"/favicon.ico","href":"/favicon.ico"} 
0 host: localhost:3000 

1 user-agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10 6 7; en-us) 
AppleWebKit/533.20.25 (KHTML, like Gecko) Version/5.0.4 Safari/533.20.27 
referer: http://localhost:3000/ 

cache-control: max-age=0 

accept: */* 

accept-language: en-us 

accept-encoding: gzip, deflate 

connection: keep-alive 


现在 有 这 个 工具 可 以 嗅 控 HTTP 服务 需 事 件 了 。 这 个 简易 的 技术 能 输出 事件 的 详细 日 志 ， 这 
样 的 模式 适用 于 所 有 EventEmitter 对 象 。 在 程序 中 ， 你 可 以 使 用 该 技术 检查 EventEmitter 对 象 的 真 
实行 为 。 


Naoaum 必 whN 
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本 节 介 绍 了 一 个 基本 Web 服 务 需 Basic Server 的 实现 。Node 提 供 了 一 个 很 好 的 HTTP 服务 器 对 
象 ， 若 再 结合 使 用 一 些 额 外 的 协议 元 素 和 服务 ， 即 可 提供 网 站 的 基本 特性 。 

Basic Server 非 常 基本 ， 它 实现 了 以 下 特性 : 
口 灵活 的 请 求 路 由 选择 ; 
口 自动 提供 解析 后 的 URL 对 象 ; 
口 自动 提取 主机 头 信息 (用 于 虚拟 主机 ); 
口 自动 提取 cookie 头 信息 ; 
口 支持 favicon.ico 请 求 ; 
口 支持 静态 文件 (HTML、JS、PNG、GIF、JPEG 等 ); 
口 灵活 的 服务 器 配置 。 

有 了 这 些 作为 目标 ，Basic Server 的 实现 代码 由 4 个 Node 模 块 、 一 个 CSS 文 件 、 一 个 或 数 个 
HTML 文 件 组 成 。 如 此 小 巧 的 尺寸 也 印证 了 Node 的 灵活 和 强大 。 

预先 有 个 准备 工作 , 那 就 是 安装 MIME 模 块 ,用 于 生成 正确 的 Content-Type 头 。 可 能 你 对 MIME 
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感 兴趣 ， 我 们 稍 后 会 详细 讨论 。 现 在 ， 敲 入 这 个 命令 : 


$ npm install mime 


Basic Server 的 实现 
在 写 代码 之 前 , 让 我 们 先 思考 一 下 实现 上 述 目标 的 策略 。Node 创 造 性 地 提供 了 这 样 的 服务 需 


架构 : 
Var server = http.createServer (function (req, res) { 
// 处 理 请 求 
J 


server.listen(port); 

我 们 的 目标 是 实现 一 个 HTTP 请 求 处 理 函 数 , 它 会 检查 每 个 请 求 , 然后 基于 请 求 属性 ,给予 每 
个 请 求 适当 的 响应 。 这 个 设计 架构 可 以 将 请 求 的 检查 和 派发 从 应 用 程序 的 业务 逻辑 中 分 离 出 来 。 

1. Basic Server 核 心 (basicserver.js) 

Basic Server 的 核心 模块 会 创建 一 个 HTTP 服 务 器 对 象 ， 附 加 Basic Server 上 用 于 检查 请 求 ， 然 
后 给 予 适当 响应 的 功能 。 

创建 名 为 basicserver .js 的 文件 ， 为 其 键入 以 下 内 容 : 





























var http = require('http'); 
var url = require('url'); 
exports.createServer = function() { 


Var htserver = http.createServer (function(req, res) { 
req.basicServer = { 
urlparsed: url.parse(req.url, true) 
}; 
processHeaders (req, res); 
dispatchToContainer (htserver, req, res); 
} 
htserver.basicServer = { containers: [] }; 
htserver.addContainer = function(host, path, 
module, options) { 
if (LookupContainer ( 
htserver, host, path) !== undefined) { 
throw new Error("Already mappeqd "+host+"/"+path); 
} 
htserver.basicServer.containers.push({ 
host: host, path: path, 
module: module, options: options }); 
return this; 
} 
htserver.useFavIicon = function(host, path) { 
return this.addContainer (host, "/favicon.ico", 
require('./faviconHandler'), 
{ iconPath: path }):; 
} 


htserver.docroot = function(host, path, rootPath) { 
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return this.addContainer (host, path, 
require('./staticHandler'), 
{ docroot; rootPath }); 
} 
return htserver; 


由 

在 Basic Server 的 这 些 核心 代码 中 ,， 有 一 个 createSservetr 国 数 。 我 们 在 给 服务 器 增加 功能 时 
用 createSserver 创 建 并 返回 一 个 HTTP 服 务 需 对 象 。 这 里 主要 展示 的 是 请 求 处 理 函 数 。 我 们 的 
策略 是 先 在 请 求 对 象 中 添加 有 用 的 信息 (在 processHeaders 气 数 中 处 理 )， 然 后 将 其 附加 到 合 
适 的 处 理 函 数 中 (在 aispatchTocontainer 函 数 中 处 理 )。 第 二 个 模块 也 将 被 使 用 同样 的 策略 
配置 你 的 服务 器 。 稍 后 ， 我 们 将 看 到 一 个 这 样 的 服务 器 配置 模块 。 

我 们 的 一 个 策略 是 将 有 用 的 数据 同时 添加 到 服务 器 ( htserver ) 和 请 求 (red ) 对 象 中 。 
为 JavaScript 是 松散 类 型 的 语言 ， 我 们 可 以 完成 添加 的 步骤 。 所 有 的 附加 操作 都 在 basicServer 对 
象 中 进行 ， 并 在 这 个 函数 中 附加 数据 到 htserver 和 regq 中 。 通 过 这 样 的 方式 我 们 可 以 添加 任何 
数据 到 htserver 上 ,因为 数据 隐藏 在 htserver .basicserver 对 象 中 , 所 以 其 他 代码 无 法 访问 
到 这 些 数据 。 

我 们 做 的 另外 一 件 事 是 添加 3 个 函数 来 管理 一 系列 容 髓 。 容 吉大 致 对 应 我 们 在 上 一 章 提 到 的 
Express 路 由 器 中 间 件 。 这 3 个 函数 添加 一 个 容器 到 服务 器 ( addcontainer ), 然后 配置 两 个 内 置 
的 容器 ， 一 个 处 理 favicon (useFavIcon )， 另 一 个 处 理 静 态 文件 (aocroot )。 

容器 由 下 面 4 块 数据 定义 : 

口 一 个 用 于 匹配 Host 头 的 正则 表达 式 ; 

口 一 个 用 于 匹配 请 求 URL 的 正则 表达 式 ; 
口 一 个 选项 对 象 ; 

口 一 个 处 理 函 数 。 

综合 上 面 的 策略 就 可 以 实现 一 个 基于 名 字 的 虚拟 主机 , 意味 着 Basic Server 可 以 通过 判断 Host 
头 部 匹配 的 容器 对 象 响应 来 自 多 个 域名 的 请 求 。 之 后 我 们 会 讨论 更 多 相关 的 内 容 。 

options 对 象 用 于 帮助 将 配置 模块 的 配置 数据 传递 到 处 理 函 数 模块 , 而 options 对 象 的 内 容 
是 由 处 理 也 数 模 块 定义 的 。 

比如 在 favicon 处 理光 数 中 ,options 对 象 包含 favicon 图 片 的 路 径 。 浏览 器 请 求 favicon 时 路 径 
一 般 都 是 /favicon.ico 结 尾 ， 这 个 路 径 是 人 硬 编码 在 容器 里 的 。 

在 前 面 的 例子 里 我 们 还 使 用 了 其 他 一 些 函 数 , 但 是 还 没有 对 其 进行 说 明 。 第 一 个 是 lookup- 
Container， 用 于 检查 containers 数 组 中 是 否 有 容器 匹配 HTTP 请 求 中 的 host 和 path 字 上 段 。 


Var lookupContainer = function(htserver, host, path) { 
fo (va Td Sr Os 
i < htserver.basicServer.containers.length; i++) { 
Var container = htserver.basicServer.containers[il]; 
Var hostMatches = host.toLowerCase() .match(container.host); 
Var pathMatches = path.match(container.path); 
if (hostMatches !== null && pathMatches !== null) { 
return { 
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container: container, 
host: hostMatches, 
path: pathMatches }; 
} 
} 
return undefined; 


} 

这 个 函数 通过 正则 表达 式 匹 配 数组 中 的 host 和 path， 实 现 了 一 个 简单 的 扫描 。 如 果 找 到 匹 
配 项 则 返回 该 项 ， 否 则 直接 返回 undefined。 

下 一 个 函数 processicaders 用 于 搜索 rea headers 数 组 以 查找 cookie 和 Host 头 部 ， 因 为 这 
两 个 字段 对 请 求 的 分 派 都 很 重要 。 和 你 在 前 面 看 到 的 请 求 处 理 函数 部 分 一 样 ,这 一 函数 在 每 一 个 
HTTP 请 求 到 达 时 都 会 被 调用 。 


Var processHeaders = function(req, res) { 

req.basicServer.cookies = []; 

Var keys = Object.keys (regq.headers); 

for (var i = 0, 1 = keys.length; i < 1; i++) { 
var hname = keys[i]; 
var hval = req.headers [hnamel]; 
if (hname.toLowerCase() === "host") { 

req.basicServer.host = hval; 














} 
if (hname.toLowerCase() === "cookie") { 
req.basicServer.cookies.push(hval); 


} 


还 有 很 多 其 他 的 HTTP 头 部 字段 ( Accept、Accept-Encoding、Accept-Language 和 User-Agent ) 
可 能 需 保存 以 供 后 续 使 用 ， 具体 视 你 的 应 用 而 定 。 
最 后 一 个 函数 是 aispatchTocontainer， 它 的 功能 就 是 查找 匹配 的 容器 ， 分 派 请 求 到 对 应 
的 容 咒 中 。 和 processHeadqers 一 样 ， 这 个 函数 会 在 每 一 个 HTTP 请 求 到 达 时 被 调用 。 


Var dispatchToContainer = function(htserver, reqg, res) { 
var container = lookupContainer (htserver, 
req.basicServer.host, 
req.basicServer.urlparsed.pathname); 
if (container !== undefined) { 
req.basicServer.hostMatches = container.host; 
req.basicServer.pathMatches = container.path; 
req.basicServer.container = container.container; 
container.container.module.handle(req, res); 
} else { 
res.writeHead(404, { 'Content-Type': 'text/plain' }); 
res.end("no handler found for "+ 
req.host +"/"+ req.urlparsed.path); 


























} 


如 果 没 有 找到 对 应 的 容器 ， 用 户 就 会 得 到 一 个 错误 页 面 (错误 状态 码 404 )。 
处 理 函 数 模块 暴露 了 函数 handle， 参数 是 req 和 res。 在 dispatchToCcontainer 中 ，Basic 
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Server 通 过 调用 handle 派 发 请 求 。 

2. favicon 处 理 函 数 (faviconHandler .js) 

Basic Server 包 含 两 个 我 们 还 没有 提 到 的 内 建 处 理 函 数 模 块 ， 第 一 个 是 favicon 处 理 函 数 
faviconHandler.js， 用 来 响应 favicon 请 求 。 当 配置 模块 使 用 了 us < 这 个 模块 
就 会 被 安装 到 Basic Server 上 : 


var fs = require('fs'); 
Var mime = require('mime'); 
exports.handle = function(req, res) { 
if (req.methogd !== "GET") { 
res.writeHead(404, { 'Content-Type': 'text/plain' }); 
res.end("invaliqd method " + req.method); 
} else if (req.basicServer.container.options.iconPpath!== undefined) { 


fs.readFile(req.basicServer.container.options.iconpPath, 
function(err, buf) { 
if (err) { 
res.writeHead(500, { 
'Content-Type': 'text/plain' }); 
res.endl 
req.basicServer.container.options.iconpath 
+" not found"); 
} else { 
res.writeHead(200, { 
'Content-Type': 
mime.lookup (regq.basicServer.container.options.iconpath), 
'Content-Length': buf.length 
上 
res.end (buf); 
} 
二 
} else { 
res.writeHead(404, { 'Content-Type': 'text/plain' }); 
res.end("no favicon"); 
} 
} 


这 个 处 理 函 数 处 理 对 favicon.ico 的 请 求 。 
重申 一 遍 ， 处 理 函 数 模块 需要 在 export 下 注册 一 个 名 为 handqle 的 图 数 function (reda， 
res) 。Basic Server 找 出 匹配 请 求 的 容器 ， 然 后 执行 处 理 函 数 的 handle 函 数 。 这 个 处 理 函 数 读 取 
iconPath 指 定 的 文件 ， 然 后 使 用 res 对 象 将 其 发 送 到 浏览 器 。 检 测 多 个 错误 条 件 后 ， 处 理 函数 
使 用 res 发 送 错 误 页 面 。 
MIME 模 块根 据 给 出 的 图 标 文件 确定 正确 的 MIME 类 型 。 网 站 图 标 favicon 可 以 是 任何 类 型 的 
图 片 ， 但 是 我 们 必须 要 告诉 浏览 器 是 哪个 类 型 。 
除了 GET 请 求 ， 该 处 理 函 数 对 其 他 请 求 都 无 效 。 所 以 它 检查 网 络 请 求 的 方法 ， 对 GET 请 求 之 
外 的 i Te an 
静态 文件 处 理 程序 (staticHandler .js) 
ee ( 响应 对 .html 或 .css 等 文件 的 请 求 )。 创 建 一 个 名 为 static- 
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Handler.js 的 文件 ， 为 其 键入 以 下 内 容 : 


Va a = require 


人 
代 


Var mime = require('mime' rs 
Var sys = require('sys'); 
exports.handle = function(req, res) { 
if (req.method !== "GET") { 
res.writeHead(404, { 'Content-Type': 'text/plain' }); 
res.end("invalid method " + req.method); 


} else { 
Var fname = req.container.options.docroot + 
req.urlparsed.pathname; 
if (fname.match(/\/$/)) fname += "index.html"; 
fs.stat (fname, function(err, stats) { 
TE ‘(EEE A 
res.writeHead(500, { 


'Content-Type': 'text/plain' }); 
res.end("file "+ fname +" not found " + err); 
} else { 


fs.readFile(fname, function(err, buf) { 
El | 
res.writeHead(500, { 


'Content-Type': 'text/plain' }); 
res.end("file "+ 
fname +" not readable " + err); 
} else { 


res.writeHead(200, { 
'Content-Type': 
mime.lookup (fname), 
'Content-Length': buf.length 
学 

res.end (buf); 


这 个 例子 展示 了 一 个 静态 文件 处 理 程序 static Handler， 用 于 处 理 文件 系统 内 的 文件 。 

docroot 选 项 指 被 存放 文件 所 在 文件 夹 的 路 径 。staticHandler 读 取 docroot 目 录 下 的 指 
定 文件 ， 如 果 文 件 存在 并 且 读 取 时 未 发 生 错 误 ， 文件 内 容 会 被 包含 在 res 对 象 中 发 送 到 浏览 器 
这 一 任务 非常 简单 。 

一 个 特殊 情况 是 使 用 MIME 模 块 ( 可 以 通过 npm 获 得 该 模块 ) 确定 正确 的 Content-Type 头 。 
MIME 类 型 是 必需 的 ， 以 便 浏览 器 正确 解析 数据 ， 稍 后 我 们 会 进一步 谈论 这 个 问题 。 

男 一 种 特殊 情况 是 ， 如 果 请 求 URL 以 /结尾 ,那么 处 理 程序 在 请 求 地 址 上 追加 ingex .html。 

4. Basic Server 的 配置 文件 (server .js) 

我 们 完成 了 Basic Server 的 所 有 组 件 ， 现在 可 以 打造 一 个 可 以 工作 的 Web 服 务 器 了 。 创建 一 个 
名 为 server .js 的 文件 并 为 其 键入 以 下 内 容 : 
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Var port = 4080; 


Var server = require('./basicserver') .createServer(); 
server.useFavIicon("localhost", "./docroot/favicon.png"); 
server.docroot ("localhost", "/", "./docroot"); 


require('./httpsniffer') .sniffOoOn(server); 
server.listen (port); 


这 一 配置 文件 中 指定 了 一 个 名 为 aGocroot 的 文件 夹 作为 静态 文件 的 根 目录 ， 这 个 目录 下 ， 名 


为 favicon.png 的 图 片 被 指定 为 网 站 图 标 。 换 句 话 说 ,我们 已 经 配置 了 一 个 简易 的 无 动态 页 面 
的 Web 服 务 需 。 








HTTP Sniffer 已 经 连接 上 ， 因 此 对 于 浏览 器 发 出 的 每 个 请 求 ， 其 详细 信息 都 会 出 现在 控制 台 。 
在 运行 服务 器 之 前 ， 让 我 们 先 看 看 要 放 在 docroot 目 录 下 的 内 容 。 
增加 几 个 HTML 文 件 有 利于 测试 服务 器 ， 这 些 HTML 文件 的 内 容 可 以 像 这 样 编写 (可 以 命名 

















为 inadex.html ): 


<html> 
<head> 
<link href="/style.css" rel="stylesheet"> 
</head> 
<body> 
<hl>Index</h1> 
<p><a href="page2.html">page 2</a></p> 
<p> 
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam 
fringilla molestie leo eu tincidunt. Donec pulvinar porttitor 
dictum. Fusce at elit mauris, a ornare ipsum. Nulla congue nisi 
non ante pellentesque vel lobortis lacus varius. Nam metus ante, 
blandit in rutrum et, pellentesque eu velit. Nulla blandit 
placerat scelerisque. Morbi odio magna, accumsan sit amet 
pharetra eu, varius sit amet ipsum. Aenean interdum libero ut est 
hendrerit dictum. Suspendisse convallis pellentesque metus 
ac tempor. Nam diam lectus, posuere eu rutrum id, facilisis vel 
tellus. 
区 
</body> 


你 可 以 使 用 喜欢 的 文本 自动 生成 工具 (http:/wwwlipsum.comy/ ) 创建 多 个 类 似 的 HTML 文 件 。 





为 了 方便 ,多 个 HTML 文 件 之 间 可 以 通过 <a> 标 签 建 立 链接 。 


该 HTMIL 文 件 引 入 了 一 个 名 为 style .css 的 CSS 文 件 ，CSS 内 容 如 下 : 


body { 
color: #00c; 
font-family: Verdana, Arial, Helvetica, sans-serif; 
background-color: #cf9 
} 
Hl1 { 
COlOor: #ff6; 
background-color: #090; 
border: solid Spx #0f9 
} 


最 后 ， 我 们 创建 一 个 名 为 favicon .png 的 小 图 片 文件 。 网 站 图 标 favicon 是 浏览 器 显示 在 地 
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址 栏 上 的 小 图 片 ， 根 据 维基 百科 的 解释 ( http://en.wikipedia.org/wiki/Favicon )， 它 是 32 x 32 或 者 
48 x 48 大 小 ( 单位 为 像素 ) 的 几乎 任意 格式 的 图 片 , 能 正常 显示 在 除了 卫 浏 览 器 ( 它 坚 持 使 用 ICO 
文件 ) 之 外 的 所 有 浏览 器 上 。 

现在 启动 Basic Server: 


$ node server.js 
在 Web 浏 览 器 中 访问 http:/Wlocalhost:4080。 


恭喜 ! 你 已 经 启动 了 Basic Server。 如 图 所 示 ， 浏 览 器 会 显示 aocroot 目 录 下 inqex.html 的 
内 容 。 





A A, http://localhost:4080/ 


[<|e | [|iIAlAI eI | | ye) [+ |ss http://localhost:4080/ © | (Qr Google ) | 送 j 


由 http:/ /localhost:4080) | + 


page 2 

















Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam fringilla molestie leo eu 
tincidunt. Donec pulvinar porttitor dictum. Fusce at elit mauris, a ornare ipsum. Nulla congue 
nisi non ante pellentesque vel lobortis lacus varius. Nam metus ante, blandit in rutrum et, 
pellentesque eu velit. Nulla blandit placerat scelerisque. Morbi odio magna, accumsan sit 
amet pharetra eu, varius sit amet ipsum. Aenean interdum libero ut est hendrerit dictum. 


Suspendisse convallis pellentesque metus ac tempor. Nam diam lectus, posuere eu rutrum 
id, facilisis vel tellus. 














Basic Server 极 易 扩展 ， 它 可 以 : 
口 设置 多 个 虚拟 域 ; 
口 添加 自 定 义 处 理 程序 ; 
口 支持 cookie 头 ; 
口 实现 HTTP 基 本 验证 "和 支持 HTTPS 请 求 。 
5. Basic Server 的 虚拟 主机 配置 
使 用 虚拟 主机 是 一 个 常见 的 需求 。 假如 需要 支持 额外 的 域名 , 你 可 能 会 像 下 面 这 样 为 每 个 虚 
拟 域 配置 一 个 文件 夹 : 
// 两 个 域名 独立 ， 内 容 也 独立 


bs.useFavIicon("example.com", "./example.com/favicon.png"); 
bs.docroot ("example.com", "/", "./example.com"); 

















Qa 在 HTTP 中 ， 基 本 验证 用 来 允许 Web 浏 览 器 或 其 他 客户 端 程序 在 请 求 时 提供 用 户 名 和 口令 形式 的 凭证 ， 详 见 
http://zh.wikipedia.org/zh-sg/HTTP9%E5S9%9F%BA9%E6%09C%AC9%E8%AE%A4%0E8%AF%81。 
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bs.useFavIicon ("example2.com", "./example2.com/favicon.png"); 
bs.docroot ("example2.com", "/", "./example2.com"); 

// 将 一 个 域名 挂 载 在 另 一 个 上 

bs.useFavIicon("parked.com", "./example.com/favicon.png"); 
bs.docroot ("parked.com", "/", "./example.com");} 


如 例 所 示 ， 我 们 可 以 将 一 个 域 挂 载 在 男 一 个 域 上 ( 配置 两 个 域 使 其 访问 同一 个 容器 )， 也 可 
以 如 下 使 用 正则 表达 式 来 配置 : 


bs.useFavIicon("parked.com|example.com", 
"./example.com/favicon.png"); 
bs.docroot ("parked.com|example.com", "/", "./example.com"); 


6. 一 个 用 于 Basic Server 的 shorturl 模 块 

常见 的 需求 不 是 将 一 个 域 挂 载 在 男 一 个 域 上 , 而 是 把 对 一 个 域 的 请 求 重 定向 到 男 一 个 上 。 例 
如 , 将 www.example.com 重 定向 到 example.com ( 移 除 www ) 上 。 男 一 个 例子 是 提供 类 似 tinyurl.com 
的 服务 ， 使 用 简短 的 URL 跳 转 到 较 长 的 URL.。 

实现 这 两 种 情况 ， 我 们 需要 在 HTTP 响 应 中 发 送 301 (永久 移 除 ) 或 者 302 ( 临时 移 除 ) 状态 码 ， 
并 且 指 定 Location 头 信息 。 有 了 这 个 组 合 信号 ，Web 浏 览 器 就 知道 要 跳 转 到 另 一 个 Web 位 置 了 。 

我 们 来 为 Basic Server 实 现 一 个 短 域名 处 理 模块 ， 它 能 为 一 份 代码 执行 302 跳 转 。 创 建 一 个 名 为 
redirector .js 的 文件 : 

















Var util = require('util'); 

Var Code2url = { 
'exl': 'http://examplel .com', 
'ex2': 'http://example2.com', 


i 
Var notFound = function(req, res) { 
res.writeHead(404, { 'Content-Type': 'text/plain' }); 
res.end("no matching redirect code found for "+ 
regq.basicServer.host +"/"+ 
req.basicServer.urlparsed.pathname); 
} 
exports.handle = function(req, res) { 
if (regq.basicServer.pathMatches[1]) { 
Var code = req.basicServer.pathMatches[1]; 


if (code2url[code]) { 
Var Url = code2url[codel]; 
res.writeHead(302, { 'Location': url }); 
res.end(); 

} else { 


notFound (req, res); 
} 
} else { 
notFound (req, res); 
} 
} 


这 是 一 个 可 以 在 Basic Server 中 使 用 的 人 处理 程序 模块 。 我 们 需要 在 server .js 中 加 入 一 行 配 
置 (配置 aocroot 容 器 之 前 ): 


server.addContainer("™.*", "/1/(.*)$", require('./redirector'), { }); 
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我 们 在 配置 容器 的 主机 和 路 径 两 个 部 分 都 用 了 正则 表达 式 。 正 则 表达 式 .* 可 以 匹配 任何 主机 
名 ， 匹 配 路 径 名 的 正则 表达 式 能 匹配 以 /17 开 头 的 路 径 ， 并 将 路 径 的 其 余部 分 记 为 子 匹配 。 

当 访 问 http:/localhost:4080/Vcodel 时 ， 路 径 名 称 匹 配 数据 会 出 现在 req.basicServer. 
pathMatches 中 , 而 /1/ 后 面 的 部 分 则 被 存 人 reqa.pbasicserver.pathMatches[1] 中 。 如 果 所 
有 部 分 匹配 成 功 ,处 理 程序 模块 会 返回 一 个 状态 码 为 302 的 HTTP 响 应 ,响应 的 位 置 头 信息 会 包含 
从 code2url 对 象 检 索 到 的 URL。 








5.4 ”MIME 类 型 和 MIME npm 包 


根据 HTTP 协 议 实现 一 个 成 功 且 正 确 的 Web 服 务 器 ， 需 要 处 理 很 多 细节 ， 其 中 一 个 细节 就 是 
Content-Type 头 ， 它 借用 自 MIME 协 议 。 

MIME 协 议 设 计 于 20 世 纪 90 年 代 初 ， 原 本 用 于 改进 电子 邮件 的 功能 。HTTP 协 议 与 其 在 同一 
时 间 段 被 设计 出 来 ， 它 们 面临 相同 的 挑战 ， 那 就 是 标识 电子 邮件 附件 或 HTTP 请 求 的 数据 格式 。 
文件 扩展 名 不 足以 完全 恰当 地 标识 文件 类 型 ， 因 为 3 个 (左右 的 ) 字符 作为 标识 符 来 说 太 短 ， 而 
且 文 件 扩展 名 没有 标准 。 于 是 ， 人 们 设计 了 Content-Type 头 和 整个 MIME 类 型 标准 来 作为 数据 类 
型 的 表示 系统 ， 并 保证 MIME 类 型 同时 适用 于 电子 邮件 和 HTTP。 

抛 开 历史 原因 ， Content-Type 头 是 必需 的 。 问 题 是 应 用 程序 如 何 知道 该 发 送 哪 一 种 
Content-Type。 对 于 某 些 应 用 ， 特 别 是 一 些 处 理 固 定数 据 的 小 型 应 用 ， 我 们 可 以 精准 地 知道 该 使 
用 哪 一 种 Content-Type 头 ， 因 为 应 用 发 送 的 数据 是 特定 已 知 的 。 

然而 staticHandler 能 发 送 任 何 文件 , 日 通常 不 知道 该 使 用 哪 种 Content-Type。 通 过 匹配 文 
件 扩展 名 列表 和 Content-Type 可 以 解决 这 个 问题 ， 但 跟 早先 说 过 的 一 样 ， 这 个 方案 并 不 完美 。 最 
好 的 实践 方案 是 使 用 一 个 外 部 的 配置 文件 ， 它 通常 由 操作 系统 提供 。 

MIME npm 包 使 用 了 Apache 项 目的 mime.types 文 件 ， 该 文件 包含 超过 600 个 Content-Type 的 
有 关 数 据 。 如 果 有 需要 ，mime 模 块 也 支持 添加 自 定义 的 MIME 类 型 。 

安装 模块 : 

$ npm install mime 
一 段 测试 代码 : 


Var mime = require('mime'); 
Var mimeType = mime.lookup('image.gif'); // ==> image/gif 
res.setHeader('Content-Type', mimeType); 


有 些 相关 的 HTTP 头 (参见 http://www.w3.org/Protocols/ 和 http://en.wikipedia.org/wiki/List_of_ 
HTTP header fields) 你 可 能 喜欢 : 
口 Content-Encoding 数据 被 编码 时 使 用 ， 例 如 gzip; 
口 Content-Language 内 容 中 使 用 的 语言 ; 
口 Content-Length” 字 节 数 ; 
口 Content-Location 能 取 到 数据 的 一 个 候补 位 置 ; 
口 Content-MD5 内 容 主 体 的 MD5 校 验 和 。 
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5.5 ”处 理 cookie 


男 一 个 重要 的 特性 是 支持 cookie。HTTP 协 议 是 无 状态 的 , 这 意味 着 Web 服 务 器 不 能 辨认 不 同 
的 请 求 发 送 端 。 那 么 在 协议 不 支持 状态 这 个 概念 时 ， 我 们 如 何 登 录 一 个 网 站 呢 ? 普 遍 的 做 法 是 ， 
服务 器 发 送 cookie 到 客户 端 浏览 嚣 ，cookie 中 定义 了 登录 用 户 的 身份 。 对 于 每 一 次 请 求 ,，Web 浏 览 
器 都 会 发 送 对 应 所 访问 网 站 的 cookie。 
Basic Server 对 识别 浏览 器 发 出 的 cookie 做 到 了 部 分 支持 ,请 求 处 理 程序 通 览 regq 对 象 的 头 信 
息 ， 识 别 cookie 头 ， 然 后 将 其 保存 到 一 个 数组 中 。 ( 参见 http://en.wikipedia.org/wiki/ 
HTTP Cookie ) 。 
下 面 的 代码 能 提取 浏览 器 发 送 的 cookie， 并 解析 hval 变 量 从 字符 串 中 提取 cookie 值 : 
var keys = Object.keys (regq.headers); 
for (var i = 0, 1 = keys.length; i < 1; i++) { 
var hname = keys[i]; 
Var hval = req.headers[hnamel]; 
if (hname.toLowerCase() === "cookie") { 
regq.basicServer.cookies.push(hval); 


} 
} 


发 送 cookie 时 ， 我 们 应 以 如 下 方式 为 Set-Cookie 或 Set-Cookie2 头 设 一 个 值 : 

res.setHeader('Set-Cookie2', .. cookie value ..); 

cookie 是 结构 化 的 文本 格式 ， 在 Basic Server ( 或 Connect ) 这 样 的 Web 框 架 中 ，cookie 的 字符 
串 解 析 和 格式 化 是 一 个 备 选 功能 。 以 下 是 现 有 的 几 个 相关 库 : 
口 https://github.com/jed/cookies/ 一 一 提供 近乎 完整 的 cookie 处 理 和 验证 ， 支 持 签名 cookie; 
口 https://github.com/bmeck/node-cookiejar 一 一 一 个 小 巧 的 cookie 解 析 库 。 


5.6 ”虚拟 主机 和 请 求 路 由 


建立 虚拟 主机 是 在 同一 IP 地 址 上 托管 多 个 域名 的 方法 。 如 Basic Server 所 示 , Node 可 以 实现 基 
于 域名 的 虚拟 主机 。 
对 于 基于 域名 的 虚拟 主机 ，HTTP 请 求 会 包含 一 个 域名 头 信息 : 


GET /path/to/request HTTP/1.1 
Host: example.com 


Node 中 的 regq 对 象 包含 一 个 名 为 headers 的 数组 ,该 数组 中 包含 了 主机 头 。 如 Basic Server 
所 示 ， 虚 拟 主 机 易于 实现 ， 只 需 检查 请 求 中 的 headers 数 组 ， 然 后 映射 请 求 到 适当 的 域 。 


5.7 发 送 HTTP 客户 端 请 求 


我 们 已 经 深入 研究 过 HTTP 服 务 顺 对 象 , 现在 我 们 来 看 它 的 客户 端 对 象 Node 包 含 一 个 HTTP 
客户 端 对 象 ， 它 用 来 发 送 HTTP 请 求 ， 而 且 是 任何 类 型 的 HTTP 请 求 。 但 是 它 不 能 仿效 一 个 全 功能 
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的 浏览 器 , 所 以 不 要 幻想 它 是 一 个 健壮 的 测试 自动 化 工具 。 使 用 它 可 以 打造 浏览 器 模拟 器 或 者 其 
他 一 些 HTTP 客 户 端 。 例 如 ， 任何 REST 式 Web 服 务 都 能 通过 HTTP 客 户 端 对 象 调用 。 

受到 wget 和 cur1 命 令 的 启发 , 接 下 来 写 一 段 可 以 发 送 HTTP 请 求 并 显示 结果 的 代码 ,。 创建 一 
个 名 为 wget .js 的 文件 ， 为 其 写 人 如 下 代码 : 


Var http = require('http'); 
Var url = require('url'); 
var util = require('util'); 


Var argUrl = process.argv[2]; 
Var parsedUrl1l = url.parse(argUrl1l, true); 


var options = { 
hosts mll; 
port: -1, 
Bath: mll;, 


method: 'GET' 
je 


options.host = parsedUrl.hostname; 

options.port = parsedUrl .port; 

options.path = parsedUrl .pathname; 

if (parsedUrl.search) options.path += "?"+parsedUrl.search; 


Var req = http.request (options, function(res) { 


util.log('STATUS: ' + res.statusCode); 
util.log('HEADERS: ' + util.inspect (res.headers)); 
res.setEncoding('utf8'); 
res.on('data', function (chunk) { 
util.log('BODY: ' + chunk); 
二 
res.on('error', function(err) { 
util.log('RESPONSE ERROR: ' + err); 
后 
3 
req.on('error', function(err) { 
util.log('REQUEST ERROR: ' + err); 
} 
req.end(); 
按 如 下 方式 运行 这 一 脚本 : 


$ node wget.js http://example.com 

11 Apr 21:34:35 - STATUS: 302 

11 Apr 21:34:35 - HEADERS: {"location":"http://www.iana.org/domains/example/", 
"server":"BigIP","connection":"close","content-length":"0"} 


例子 中 展示 了 一 个 状态 码 为 302 ( 重 定向 ) 的 HTTP 响 应 ， 它 告诉 浏览 带 需 要 跳 转 到 
http:/www.iana.org/domains/example/。 事 实 上 ， 如 果 在 浏览 絮 中 访 | ed ait ， 最 后 会 
跳 转 到 iana.org。 

wget .js 的 作用 就 是 发 送 HTTP 请 求 ， 然 后 显示 响应 的 各 种 细节 。 
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HTTP 请 求 在 http . request 方法 中 被 初始 化 ， 如 下 : 


Var http = request('http'); 


var options = { 
host: 'example.com', 
Dorts ‘80, 
Dath: nll.; 


method: 'GET' 

有 

Var request = http.request (options, 
function(response) { .. }); 


options 对 象 描述 了 将 要 发 出 的 请 求 ， 得 到 响应 后 其 中 的 callback 函 数 会 执行 。options 
对 象 通过 host 、port 和 path 直 接 指 定 了 请 求 的 URL。 请求 的 method 字 有 段 必 须 是 一 个 HTTP 动 作 
(GET、PUT、POST 等 )。 我 们 也 可 以 在 一 个 headers 数 组 中 存放 HTTP 请 求 的 头 信息 。 例 如 ， 提 


供 一 个 cookie: 





var options={ 


headers: { 
'Cookie': '.. cookie value' 
} 
}3 


response 对 象 是 一 个 EventEmitter， 它 能 派发 aata 和 error 事 件 。gdata 事 件 在 数据 到 达 时 
被 触发 ，error 事 件 在 发 生 错误 时 被 触发 。 

request 对 象 是 一 种 WritableStream， 它 在 HTTP 请 求 中 携带 数据 ( 例如 PUT 或 POST ) 时 很 有 
用 。HTTP 请 求 中 的 数据 格式 通过 MIME 协 议 来 声明 。 例 如 ， 提 交 HTML 表 单 时 它 的 Content-Type 
会 被 设置 成 multipart/form-data。 

要 在 HTTP 客户 端 请 求 中 发 送 数据 , 我 们 只 需 调 用 .write 方法 并 写 人 符合 规范 的 数据 , HTTP 
协议 中 定义 了 许多 用 途 广泛 的 选项 来 声明 数据 格式 。 本 书 不 会 精确 列 出 各 种 HTTP 请 求 的 格式 ， 
你 可 以 通过 以 下 代码 库 来 研究 它们 : 

口 https://github.com/coolaj86/abstract-http-request 一 一 HTTP 请 求 系统 的 高 级 包装 器 ; 
口 https://github.com/danwrong/restler 一 一 REST 客 户 端 库 ; 

口 https://github.com/maxpert/Reston 一 一 REST 客 户 端 库 ; 

口 https://github.com/pfleidilnode-wwwdude 一 一 REST 客 户 端 库 ; 

口 https://github.com/cloudhead/http-console 一 一 HTTP 请 求 的 交互 Shell。 














5.8 小结 


本 章 我 们 学 习 了 如 下 知识 : 
口 EventEmitter 以 及 它们 在 HTTP 客 户 端 和 服务 器 对 象 中 所 扮演 的 角色 ; 
口 使 用 EventEmitter 来 分 离 HTTP 数 据 请 求 过 程 和 数据 接收 机 制 ; 
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口 为 了 辅助 调试 ， 监 听 HTTP 对 象 或 其 他 EventEmitter 的 所 有 事件 ; 
口 实现 HTTP 服 务 器 ; 
口 在 HITP 服 务 器 中 路 由 接收 到 的 请 求 ; 
口 使 用 MIME 协 议 标 识 内 容 的 数据 类 型 ; 
口 实现 HTTP 客 户 端 。 
目前 为 止 , 我 们 已 经 学 习 了 使 用 Node 实 现 一 个 Web 应 用 的 基本 知识 , 下 一 个 目标 是 开发 更 有 
用 的 应 用 程序 。 这 意味 着 我 们 要 存储 和 操作 数据 。 下 一 章 , 我 们 将 讨论 在 外 部 数据 存储 空间 中 存 
取 数 据 的 几 种 方式 。 
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为 了 给 本 书画 上 一 个 圆满 的 句号 ,我 们 再 看 看 使 用 Node 存 取 数 据 的 方法 。 作 为 一 个 Web 框 架 ， 
Express 无 论 有 多 么 强大 , 要 是 没有 数据 存储 服务 的 支持 , 它 的 用 途 始 终 有 限 。 通常 我 们 的 最 佳 做 
法 是 使 用 数据 库存 储 数据 。 从 传统 的 SQL 数据 库 ， 到 现代 NoSQL 中 面向 文档 的 数据 库 、 键 值 对 数 
据 存 储 , 还 有 像 YQL 这 样 提供 基础 查询 服务 的 在 线 数据 库 , 种 类 繁多 的 数据 库 技术 能 够 满足 各 种 
各 样 的 应 用 场景 。 

在 这 一 章 中 ， 我 们 将 实现 两 个 不 同 的 便签 应 用 程序 。 这 两 个 应 用 程序 基于 Express 框 架构 建 ， 
展示 了 CRUD (创建 、 读 取 、 更 新 和 删除 ) 操作 ， 还 用 到 了 Node 的 SQL 和 MongoDB 模 块 。 


6.1 Node 的 数据 存储 引擎 


除了 在 文件 系统 中 读 写 文件 的 功能 ，Node 未 能 原生 支持 任何 数据 存储 功能 。 使 用 类 似 数据 
库 等 其 他 数据 存储 系统 则 意味 着 我 们 需要 使 用 数据 库 交 互 模块 。Node 的 wiki 列 出 了 一 些 数据 库 
交互 模块 , 它们 涉及 与 CouchDB 、MongoDB 、MySQL 、Postgres 、SQLite3 、Memcache 、REDIS 、 
YQL 等 的 交互 。 

详细 内 容 可 以 参考 https:/github.conyjoyentnode/wiki/modules#database。 

一 般 情 况 下 ， 安 装 模 块 的 同时 还 需要 安装 模块 依赖 的 其 他 部 分 ， 包 括 数据 库 客户 端 。 例 如 ， 
MySQL 模 块 依赖 一 个 MySQL 服 务 器 和 一 个 MySQL 客 户 端 库 。 


6.2 SQLite3 一 一 轻 量 级 的 进程 内 SQL 引擎 


SQL 数 据 库 并 不 必然 依赖 重量 级 的 数据 库 服务 器 和 高 薪 数 据 库 管理 人 员 。SQLite3 
( http://www.sqlite.org/ ) 的 安装 非常 方便 , 它 是 一 个 无 服务 器 且 无 需 配 置 的 SQL 数 据 库 引 擎 , 仅仅 
是 作为 一 个 独立 的 库 被 链接 到 应 用 程序 上 。node-sqlite3 ( https:// github.com/developmentseed/ 
node-sqlite3 ) 就 是 sqlite3 的 Node 版 本 。 















































6.2.1 安装 SQLite 3 


如 果 已 经 安装 了 npm，SQLite 3 的 安装 就 非常 简单 : 


$ npm install sqlite3 





84 第 6 章 存 取 数据 





安装 此 模块 之 前 需要 先 在 系统 上 安装 sqlite3 库 ， 还 有 包含 了 原生 代码 ( 基于 C 语 言 ) 用 于 链 
接 sqlite3 的 npm 模 块 。Mac OS X 已 经 安装 了 sqlite3 ， 如 果 你 使 用 的 Linux 版 本 还 没有 安装 sqlite3 ， 
安装 过 程 也 只 是 执行 包 管理 器 的 一 行 命令 (例如 apt-get install libsalite3 ) 而 已 。 使 用 
这 一 数据 库 及 其 命令 行 工具 的 方法 和 C 语 言 的 API 都 可 以 在 salite3 的 Web 站 点 (httpy/ 
sqlite.org/ ) 上 找到 。 


6.2.2 用 SQLite3 实现 便签 应 用 


为 了 探索 sqlite3 的 用 法 ， 我 们 将 实现 一 个 简单 的 应 用 程序 ， 它 可 以 输入 和 显示 便签 。 随 后 ， 
这 个 应 用 程序 还 会 用 MongoDB 实 现 一 遍 。 

由 于 这 个 应 用 是 基于 SQL 数据 库 构建 的 ， 所 以 Notes 数 据 库 的 结构 需要 用 SQL 语言 描述 ， 
CREATE TABLE 这 个 SQL 命令 存在 于 notesqb-salite3 .js 的 下 述 代码 中 : 


CREATE TABLE IF NOT EXISTS notes ( 
ta DATETIME, 
author VARCHAR (255), 
note TEXT 

) 


ts 字段 是 一 个 时 间 改 ， 用 于 标识 便签 ，author 字 有 段 用 于 标识 便签 作者 ，note 字 有 段 则 包含 便 
签 的 完整 内 容 。 

1. 数据 库 抽象 模块 一 一 nodesdb-sqlite3.js 

这 个 模块 是 一 个 数据 库 接口 库 , 它 把 SQL 命 令 封装 在 一 个 模块 中 ,然后 提供 给 应 用 程序 的 其 
他 部 分 使 用 。 它 通过 函数 aqqa ( 添加 便签 )、finqNoteByIa (查找 并 读 取 便 签 )、edit ( 编辑 便 
签 ) 和 delete (删除 便签 ) 为 便签 应 用 全 面 实现 了 CRUD 操 作 功 能 。 

这 个 模块 的 目的 是 封装 对 SQLite3 的 调用 。 它 提供 一 些 方法 用 于 建立 数据 库 表 、 在 表 中 插入 
数据 项 、 返 回 表 中 的 所 有 数据 行 ， 还 有 删除 表 中 的 数据 项 从 而 帮助 我 们 实现 MVC 架 构 。 


var util = require('util'); 
Var sqlite3 = require('sgqlite3'); 
sqlite3.verbose(); 
var db = undefined; 
exports.connect = function(callback) { 
db = new sqlite3.Database("chap06.sqgqlite3", 
sqlite3.O0OPEN_READWRITE | sqlite3 .OPEN_CREATE, 
function(err) { 
if (err) { 
utils.log('FAIL on creating database ' + err); 
callback (err); 
} else 
callback (null) 









































} 
四 
} 
exports.disconnect = function(callback) { 
Callback(nully}y 
} 
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exports.setup = function(callback) { 
db.run("CREATE TABLE IF NOT EXISTS notes "+ 
"(ts DATETIME, author VARCHAR(255), note TEXT)" 
function(err) { 
if (err) { 
util.log('FAIL on creating table ' + err); 
callback (error); 
} else 
callback (null); 
3 
} 


以 上 是 实现 管理 功能 的 代码 , 通过 模块 和 函数 提供 打开 、 关 闭 和 设置 数据 库 表 的 功能 。 数据 
库 名 是 直接 硬 编码 的 , 所 以 当 调 用 connect 和 setup 函 数 时 , 当前 目录 中 就 会 生成 cnap06 .sqlite 
文件 。 

本 章 的 后 面部 分 会 介绍 一 个 名 为 notesdb-mongoose .js 的 模块 , 它 和 此 处 的 模块 共享 同一 
个 API。notesdb-mongoose 使 用 Mongoose 模 块 与 MongoDB 实 例 通信 , 例如 此 处 disconnect 子 
数 是 空 的 ， 但 是 后 面 的 Mongoose 版 本 会 真正 断 开 与 Mongoose 的 连接 。 


XDOrtS.emtyNote = { "ta MT autheor: ™" Note: ™™ }s 
exports.add = function(author, note, callback) { 
db.run("INSERT INTO notes ( ts, author, note) "+ 
vALUBS ( Py 3 3 sy 
[ new Date(), author, note ]， 
function(error) { 


























1 下 (FEOE) { 
util.log('FAIL to add ' + error); 
callback (error); 
} else 
callback (null); 
A 
} 


addq 函 数 直接 使 用 SQL 语句 在 数据 库 中 添加 数据 项 。 
SQLite3 对 应 的 .run 函 数 接受 一 个 字符 串 参 数 ， 其 中 ?表示 占 位 符 ， 如 例子 所 示 ， 占 位 符 的 
值 必须 通过 一 个 数组 传递 进来 。 这 种 使 用 字符 串 参 数 的 方式 普遍 存在 于 各 种 语言 的 SQL 实 现 中 。 
对 于 SQLite3, 你 需要 传递 一 个 数组 , 数组 中 的 每 一 项 对 应 SQL 语句 中 的 一 个 “?” 符 号。 然后 SQL 
接口 会 自动 将 其 转换 成 SQL 语句 。 
值得 注意 的 是 调用 者 提供 了 一 个 回调 函数 , 然后 通过 这 个 回调 函数 来 声明 错误 。 模 型 本 身 不 
知道 如 何 向 用 户 展示 错误 ， 所 以 只 能 期 望 调用 函数 更 好 地 处 理 错误 了 。 
exports.delete = function(ts, callback) { 
db.run("DELETE FROM notes WHERE ts = ?2;", 
[tS J] 
function(err) { 
if (err) { 
util.log('FAIL to delete ' + err); 
callback (err); 


} else 
callback (null); 
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过 
} 


这 里 的 aelete 函 数 负 责 从 数据 库 中 删除 便签 。 
需要 注意 的 是 , 我 们 使 用 时 间 改 标识 需要 删除 的 便签 , 且 整 个 模块 中 我 们 都 使 用 时 间 戳 标记 
待 操 作 的 标签 。 数 据 库 中 的 ts 字段 在 add 函 数 中 被 初始 化 : 


exports.edit = function(ts, author, note, callback) { 
db.run("UPDATE notes "+ 
SBT tes Fr AULNOE =. 3 NMOLe .= 2 和 
"WHERE ts 三 ?", 
[ ts, author, note, ts ], 
function(err) { 
if (err) { 
util.log('FAIL on updating table ' + err); 
callback (err); 
} else 











callback (nulLl)s 
i 
} 
edit 函 数 的 作用 是 更 新 便签 。 例 子 中 使 用 SQL 语句 UPDATE， 以 新 的 便签 内 容 和 时 间 戳 作为 
参数 来 更 新 便签 : 





exports.allNotes = function(callback) { 
util.log(' in allNote'); 
db.all("SELECT * FROM notes", callback); 
} 
exports.forAll = function(doEach, done) { 
db.each ("SELECT * FROM notes", function(err, row) { 
if (err) { 
util.log('FAIL to retrieve row ' + err); 
done (err, null); 
} else { 
doEach (null, row); 
} 
}, done); 


} 


allNotes 和 foraAll 函 数 是 操作 所 有 便签 条 目的 两 种 方法 。al1Notes 把 数据 库 中 所 有 的 数 
据 行 收集 到 一 个 数组 里 ,而 forA11 方 法 可 以 接受 两 个 回调 函数 : 每 当 从 数据 集中 拿 到 一 行 数据 ， 
回调 函数 doEach 都 会 执行 一 遍 ， 当 读 完 所 有 数据 时 ， 回 调 函 数 done 就 会 执行 。 

foraAl1 每 次 只 处 理 一 行 数据 ， 相 比 而 言 ， 很 显然 al1Notes 会 占用 更 大 的 内 存 。 


exports.findNoteById = function(ts, callback) { 
var didone = false; 
db.each ("SELECT * FROM notes WHERE ts = ?"， 
[ By 
function(err, row) { 
if (err) { 
util.log('FAIL to retrieve row ' + err); 
callback (err, null); 
} else { 
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if (!didone) { 
callback (null, row); 
didone = true; 


3 
} 


fingNotesById 消 数 返回 以 时 间 惟 标识 的 一 个 便签 的 相关 数据 ， 一 个 时 间 礁 能 标识 数据 库 
中 的 一 些 特定 行 。 我们 还 使 用 了 一 个 标志 来 保证 回调 函数 只 被 执行 一 次 ,以免 处 理 其 他 具有 相同 
时 间 惟 的 数据 行 。 

2. 初始 化 数据 库 一 一 setup .js 

因为 Node 的 salite3 模 块 基于 salite3 库 运作 ， 所 以 一 般 的 sqlite3 工 具 都 能 处 理 用 
note-sqlite3 创 建 的 数据 库 。 例 如 ， 我 们 可 以 使 用 如 下 的 sqlite3 命 令 创建 一 个 数据 库 。 


二 站 六 














Terrninal 一 bash 一 88x9 

$ sqlited chapb0 .sqliteD 国 
SQLite version JI.7.0 

Entcr ".hceclp" for instructions 

Entcr SQL statcmcnts torminatced with aq "s" 


Sqlito: CREATE TABLE notcs 《ts DATETIME, author YARCHARC255), notc TEXT);s 








zqlite» .schemg notes 0 
CREATE TABLE notes (ts DATETIME, author VARCHARC255), note TEXTYs 全 
sqlite> [ T 











我 们 也 可 以 借助 notesdab 模 块 ， 写 一 个 setup . js 脚本 来 初始 化 数据 库 : 


var util = require('util'); 
Var async = require('async'); 
var notesdb = require('./notesdb-sqlite3'); 
// var notesdb = require('./notesdb-mongoose'); 
notesdb.connect (function(error) { 
if (error) throw error; 
二 这 
notesdb.setup(function(error) { 
if (error) { 
util.log('ERROR ' + error); 
throw error; 
. 
async.series([ 
fu Lior (EB) ‘+t 
notesdb.add("Lorem Ipsum "， 
"Cras metus. Sed aliquet risus a tortor. Integer id quam. 
Morbi .. fermentum non, convallis id, sagittis at, neque.", 
fumnetion (errory 
if (error) util.log('ERROR ' + error); 
cb(error); 
下放 
} 
ja 
function(error, results) { 
if (error) util.log('ERROR ' + error); 
notesdb.disconnect (function(err) { }); 
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} 
值得 注意 的 一 点 是 两 次 请 求 调用 不 同 的 notesdb 模 块 ， 然 而 真正 执行 的 只 有 
require('notesdb-sqlite3')。 之 后 我 们 会 在 Mongoose 模 块 中 重用 这 一 脚本 ， 由 于 内 部 的 
API 是 一 样 的 ， 我 们 只 需要 通过 修改 模块 名 完成 数据 库 的 切换 。 
之 前 我 们 已 经 对 数据 库 进行 了 填充 ， 你 还 可 以 按照 自己 的 喜好 重复 notesdb.add 操 作 。 我 
们 在 这 里 需要 考虑 的 问题 是 在 什么 时 候 调 用 .qdisconnect 子 数 。 如 果 我 们 在 所 有 的 aqa 操 作 完 成 
前 调用 了 gisconnect 方 法 ,一 部 分 aqd 操 作 可 能 会 执行 失败 。 注 意 ， 这 些 函 数 是 异步 执行 的 ， 
add 操 作 的 执行 顺序 可 能 与 其 在 源 代码 中 定义 的 不 一 致 。 
在 这 里 async 模 块 用 于 在 调用 disconnect 方 法 后 正确 调控 一 些 aqd 操 作 的 执行 。 正 常情 况 
下 回调 函数 会 在 后 台 运 行 ， 如 果 在 notesdpb.disconnect 方 法 后 脚本 调用 了 好 几 次 
notesdb.add，disconnect 操 作 可 能 会 在 所 有 add 操 作 完 成 之 前 运行 。async 模 块 是 非常 重要 
的 。 它 可 以 完成 很 多 工作 ，async. series 函数 可 以 控制 函数 按 顺 序 执行 ， 从 而 保证 最 后 的 函数 
在 所 有 其 他 函数 完成 之 后 执行 。 
3. 在 控制 台 显示 便签 show.js 
如 同 先前 提 到 的 , notesqdb.forAll 方 法 能 检索 到 数据 库 中 的 每 条 便签 ， 所 以 我 们 能 利用 它 
将 数据 库 信 息 输 出 到 控制 台 ， 代 码 如 下 : 
Var util = require('util'); 
Var notesdb = require('./notesdb-sqlite3'); 
// var notesdb = require('./notesdb-mongoose'); 
notesdb.connect (function(error) { 
1 (EHDOE) . Theow BEEPOE> 
上 
notesdb.forAll (function(error, row) { 
util.log('ROW: ' + util.inspect (row)); 
}, function(error) { 
if (error) throw error; 
util.log('ALL DONE'); 


notesdb.disconnect (function(err) { }); 
}) 


我 们 可 以 按 如 下 方式 运行 脚本 。 
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$ node show | 日 
6 Jul 15:39:32 - ROW: { ts: 1369991225472， ~ 

author: 'Lorem Ipsum 12 '， 

note: 'Lorem ipsum dolor sit amet ，consectetur adipiscing elit。Integer nec odio ，Praese 
nt libero. Sed cursus ante dopibus diam. Sed nisi. Nulla quis sem at nibh elementum imperd 
iet. Duis sogittis ipsum. Praesent, mauris. Fusce nec tellus sed augue semper porta. Mouris 
massa. Vestibulum lacinia arcu eget nulla. Class aptent taciti Sociosqu ad litora torquen 
+ per conubia nostra, per inceptos himenaeos. Curabitur sodales ligula in libero. Sed dign 
issim lacinia nunc.' } 
6 Jul 15:39:32 - ROW: { ts: 1389991225498， 

author: ‘Lorem Ipsum 23°, 

note: “Curabitur tortor. Pellentesque nibh. Aenean quam. In scelerisque sem at dolor. Ma 
ecenas mattis. Sed convallis tristique sem. Proin ut ligula vel nunc egestas porttitor. Mo 
rbi lectus risus, iaculis vel, suscipit quis, luctus non, massa. Fusce ac turpis quis ligu 
la lacinia aliquet. Mauris ipsum. Nulla metus metus, ullamcorper vel, tincidunt sed, euism 











NR? 
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4. 整 合 便签 应 用 app.js 
现在 我 们 已 经 知道 如 何 通过 notesdb-sqlite3 .js 操作 数据 库 ， 让 我 们 将 其 整合 到 一 个 基 
于 Express 的 简单 应 用 中 ,其 中 notesdb-sqlite3 .js 作为 便签 应 用 的 模型 部 分 ， 而 app .js 会 扮 
演 控 制 器 的 角色 。 我 们 马上 会 看 到 一 些 模板 文件 ,这 些 文件 将 帮助 展示 这 一 方法 。 和 我 们 已 经 
过 的 两 个 脚本 文件 show.js 和 setup.js 一 样 ，app.js 也 参照 了 之 前 的 写法 ， 可 以 轻易 在 
notesdb-sqlite3.js 和 notesdb-mongoose.js 模 块 之 间 切 换 : 


var util = require('util'); 

var url = require('url'); 

Var express = require('express'); 

Var nmDbEngine = 'sqlite3'; 

// var nmDbEngine = 'mongoose'; 

Var notesdb = require('./notesdb-'+nmDbEngine); 
Var app = express.createServer(); 

app.use (express.logger()); 

app.use (express.bodyParser ()); 
app.register('.html', require('ejs')); 
app.set('views', dirname + '/views-'+nmDbEngine); 








app.set('view engine', 'ejs'); 
ee Us 的 模块 ， 并 配置 Express 服 务 右 组 件 。 
这 里 我 们 需要 重点 介绍 nmDbEngine 变 量 和 它 的 使 用 。 这 个 变量 用 于 命 ise 选择 











有 适 的 views 目 录 。 它 们 都 因数 据 库 引擎 的 不 同 而 不 同 , 不 过 app .js 
可 以 保持 不 变 : 


Var parseUrlParams = functionl(req, res, next) { 
req.urlP = url.parse(req.url, true); 
next (); 


} 
notesdb.connect (function(error) { 
if (error) throw error; 
这 
app.on('close', function(errno) { 
notesdb.disconnect (function(err) { }); 
3 


在 此 ，connect 和 aisconnect 函 数 用 于 维护 数据 库 的 连接 。 
parseUrlParams 国 数 是 一 个 路 由 中 间 件 函数 , 用 于 在 一 些 路 由 器 函数 中 解析 URL 查 询 参数 : 


app.get('/', functionl(req, res) { res.redirect('/view'); }); 
app.get ('/view', function(req, res) { 
notesdb.allNotes (function(err, notes) { 
if (err) { 
util.log('ERROR ' + err); 
throw err; 
} else 
res.render('viewnotes.html', { 
title: "Notes ("+nmDbEngine+")", notes: notes 
] 这 
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这 里 我 们 在 浏览 絮 中 展示 了 一 系列 便签 。 

首先 我 们 要 做 的 是 通过 调用 res .redirect ('/view') 将 一 个 请 求 从 / 重 定向 到 /view。 
/view 页 面 会 被 作为 便签 应 用 的 主 界面 ， 许 多 路 由 器 函数 都 会 将 请 求 重 定 向 到 这 个 页 面 。 

页 面 的 泻 染 由 viewnotes .html 模 板 完成 , 我 们 会 在 后 面 介 绍 这 部 分 内 容 。 泻 染 过 程 调用 了 
两 个 变量 ，tit1le 用 于 包含 页 面 标题 字符 串 ，notes 是 一 个 便签 数组 。 该 模板 会 处 理 并 尝 染 所 给 
出 数组 中 所 有 的 便签 : 


app.get('/add', function(req, res) { 
res.render('addedit.html', { 
title: "Notes ("+nmDbEngine+")", 
postpath: '/add', 
note: notesdb.emptyNote 
} 
上} 
app.post('/add', function(req, res) { 
notesdb.add (req.body.author, req.body.note, 
function(error) { 
if (error) throw error; 
res.redirect('/view'); 
J} 
} 3 


我 们 在 此 通过 一 些 路 由 函数 添加 便签 到 数据 库 中。 
其 中 需要 讨论 的 实现 细节 是 两 个 负责 路 由 到 /aaa 目录 的 函数 。 当 用 户 单 击 Add 按 钮 时 





















































app.get ('/add',...) 内 的 函数 就 会 被 调用 。 浏 览 器 会 发 出 一 个 发 往 /agqd 的 HTTP GET 请 求 。 
这 个 函数 使 用 adqedit .ntml 模 板 来 创建 一 个 表单 ， 让 用 户 通过 这 个 表单 输入 标签 ， 然 后 通过 单 
击 Submit 按 钮 提交 。 


模板 addedit.html 用 于 处 理 /add 和 /edit 操 作 ， 它 期 望 接受 一 个 Note 对 象 。 
Notesdb .emptyNote 对 象 是 一 个 空 的 便签 ， 适 合 在 不 存在 便签 对 象 时 使 用 

在 用 户 提 交 表 单 时 ， 浏 览 器 就 会 发 起 一 个 HTTP POST 请 求 ，app .post ('/add',...) 中 的 
函数 就 会 被 调用 。 用户 输入 的 数据 会 被 存放 在 请 求 主体 中 , 而 请 求 主体 会 被 bodyParser (app.use 
(express .bodyParser())) 中 间 件 处 理 并 存放 在 req .body 中 。 最 后 我 们 可 以 通过 req .body. 
author 和 req.body .note 使 用 用 户 输入 的 数据 。 


app.get('/del', parseUrlParams, functionl(req, res) { 
notesdb.delete(regq.urlP.gquery.id, 
function(error) { 
if (error) throw error; 
res.redirect('/view'); 
上 
> 


这 个 路 由 器 函数 用 于 删除 数据 库 中 的 便签 。 

我 们 将 parseUr1Parmas 用 作 路 由 中 间 件 的 理由 是 标签 标识 符 会 作为 URL 查 询 参数 出 现 , 并 且 
标识 符 以 ia 命名 。 因 此 , 我 们 可 以 继续 并 通过 编写 req.ur1lP.dquery.id 访 问 iq 参 数 ， 而 不 用 再 次 
编写 解析 URL 的 代码 。 当 notesdb .delete 操 作 完成 后 ， 我 们 会 将 应 用 重 定向 到 /view 处 的 主页 。 





[e] 
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app.get ('/edit', parseUrlParams, function(req, res) { 
notesdb.findNoteById (req.urlP.query.id, 
function(error, note) { 
if (error) throw error; 
res.render('addedit.html', { 
title: "Notes ("+nmDbEngine+")", 
postpath: '/edit'"', 
note: note 


上 
app.post('/edit', function(req, res) { 
notesdb.edit (regq.body.id, req.body.author, reg.body.note, 
function(error) { 
if (error) throw error; 
res.redirect('/view'); 
下 小 
3 
app.listen(3000); 


这 个 路 由 器 函数 用 于 编辑 数据 库 中 的 便签 。 

我 们 再 次 使 用 了 parseUrlParams 中 间 件 从 URL 查 询 参 数 中 获取 便签 ia， 并 使 用 这 个 ia 和 
notesdb.findNoteById 函 数 获取 便签 。 注 意 ， 我 们 再 次 使 用 aadedit .html 泻 染 页 面 ,但 是 
这 次 发 送 到 页 面 上 的 便签 取 自 数据 库 。 

之 前 postpath 变 量 被 设置 成 /adada， 而 现在 要 设置 成 /edit。 这 个 变量 是 adadedait .html 中 




















表单 提交 的 目的 地 ,确保 调用 正确 的 app.post 子 数 ， 即 调用 app.post('/add',...) 或 者 
app.post('edit',...)o 


5. 便签 应 用 的 模板 
在 运行 便签 应 用 之 前 ， 我们 必须 设置 在 app.js 中 引用 的 模板 ， 这 些 模 板 包 括 
viewnotes.html、 addedit .html 和 layout .html。 
后 续 的 文件 必须 放置 在 views-sqlite3 目 录 下 。 之 后 我 们 会 创建 男 外 一 个 目录 一 一 views- 
mongoose， 用 于 存放 Mongoose 模 板 。 
让 我 们 从 layout .html 模 板 开始 : 
<html> 
<head><title><%= title %></title></head> 
<body> 
<h1l><%= title %></hi> 


<p><a href='/view'>View</a> | <a href='/add'>Add</a></p> 
< 外- body %$> 











</body> 
<html> 
这 是 便签 应 用 的 页 面 布局 , 非常 简洁 。 它 会 处 理 app .js 中 调用 res .render 时 接收 的 title 


变量 。 
现在 看 下 viewnotes .ntml 模 板 : 


<table><% notes.forEach (function(note) { 


op 
V 
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七 认 光 居 七 各 区 
<p><%$= new Date(note.ts) .toSstring() %>: 
by <b><%= note.author %></b></p> 
<p><%= note.note %></p> 
</bd><tds 
<form method='GET' action='/del'> 
<input type='submit' value='Delete' /> 
<input type='hidden' name='id' value='<%= 
note.ts 和 > "> 
</form> 
<br/><form method='GET' action='/edit'> 
<input type='submit' value='Edit' /> 
<input type='hidden' name='id' value='<%$= 
note.ts %$>'> 
</form> 
</td></tr><% }); %$></table> 


个 版 本 适用 于 基于 SQLite3 的 便签 应 用 。 它 展示 了 标签 的 时 间 戳 、 标 题 和 内 容 ， 还 有 两 个 
ve 1 或 者 编辑 /edit 便签 的 表单 。 

这 里 有 一 个 隐藏 的 表单 值 ia， 而 在 基于 SQLite3 的 标签 应 用 中 我 们 使 用 时 间 戳 来 标识 便签 
之 前 针对 删除 或 编辑 操作 讨论 app .post 函 数 时 ， 我 们 通过 解析 URL 参 数 来 获取 iad 参 数 ， 而 这 个 
id 就 来 自 表 单 中 的 隐藏 值 。 

现在 看 下 addedit .html: 






































<form method='POST' action='<%= postpath %>'> 
< 外 if (note) { %$> 
<input type='hidden' name='id' value='<%= note.ts %>'> 
< 外 } %> 
<input type='text' name='author' value='<%= note.author %$>'/> 
<br/> 
<textarea rows=5 cols=40 name='note' ><%= 
note.note 
%$></textarea> 
<br/><input type='submit' value='Submit' /> 
</form> 


个 表单 在 添加 ( /aaa ) 和 编辑 ( /edit ) 便签 时 都 会 用 到 。 Sr 变量 的 值 被 设 定 
Pe id 其 他 表单 值 从 app .js 传递 来 的 便签 对 象 中 获取 , 这 里 有 可 能 是 emptyNote 
对 象 。 
6. 启动 基于 SQLite3 的 便签 应 用 
现在 我 们 已 经 把 各 个 部 分 整合 成 一 个 应 用 , 便签 应 用 已 经 能 够 正常 运行 。 如 果 你 在 之 前 已 经 
运行 过 setup . js， 那么 数据 库 也 已 经 配置 好 了 ， 如 果 还 没有 运行 过 ， 那 现在 运行 一 下 。 我 们 现 
在 可 以 通过 下 面 的 方式 运行 应 用 。 


$ node app 


由 于 执行 了 app.1isten(3000) 语 句 ， 所 以 我 们 可 以 在 http://localhost:3000/ 上 访问 应 用 。 大 
致 的 界面 如 下 。 
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A Notes (sqlite3) 

[<|e [IAIAl le [1 | [| es [+ |® http://localhost:3000/view © | (Qr Google ) EE] 
有 Notes(sqlite3) _ se 
Notes (sqlite3) 

View | Add 





Wed Jul 06 2011 15:27:05 GMT-0700 (PDT): by Lorem Ipsum 12 
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed 

nisi. Nulla quis sem at nibh elementum imperdiet. Duis sagittis ipsum. Praesent mauris. Fusce nec tellus sed augue scmper 

porta. Mauris massa. Vestibulum lacinia arcu eget nulla. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per (Edit ) 
inceptos himenaeos- Curahitmr sodales ligula in lihero. Sed dignissim lacinia nunc. 
Wed Jul 06 2011 15:27:05 GMT-0700 (PDT): by Lorem Ipsum 23 
Curabitur tortor. Pellentesque nibh. Aenean quam. In scelerisque sem at dolor. Maecenas mattis. Sed convallis tristique sem. 

Proin ut ligula vel nunc egestas porttitor. Morbi lectus risus, iaculis vel, suscipit quis, luctus non, massa. Fusce ac turpis quis 

ligula lacinia aliquet. Mauris ipsum. Nulla metus metus, ullamcorper vel, tincidunt sed, euismod in, nibh. Quisque volutpat 
condimenturm velit. Class aptent taciti sociosdu ad litora toryuent per conubia nostra, per inceptos himenaeos. 

Wed Jul 06 2011 15:27:05 GMT-0700 (PDT): by Lorem Ipsum 34 





Nam nec ante. Sed lacinia, urna non tincidunt mattis, tortor neque adipiscing diam, a cursus ipsum ante quis turpis. Nulla 
facilisi. Ut fringilla. Suspendisse potenti. Nunc feugiat mi a tellus consequat imperdiet. Vestibulum sapien. Proin quam. Etiam 
ultrices. Suspendisse in justo eu magna luctus suscipit. Sed lectus. 


Wed Jul 06 2011 15:27:05 GMT-0700 (PDT): by Lorem Ipsum 45 


Integer euismod lacus luctus magna. Quisque cursus, metus vitae pharetra auctor, sem massa mattis sem, at interdum magna 
augue eget diam. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae: Morbi lacinia 


PEA 











如 果 你 单 击 了 Delete 按 钮 , 浏览 器 会 快速 刷新 页 面 , 然 后 你 会 发 现 已 单 击 删 除 的 条 目 已 经 消 
失 。 因 为 app. get ('/del'..) 只 是 调用 Jnotesdb.delete 方 法 ， 人 然后 马上 重 定向 到 /view， 
所 以 会 有 一 个 快速 的 刷新 过 程 。 

接 下 来 我 们 可 以 添加 ( 单 击 Add 链 接 ) 或 者 编辑 ( 单 击 Edit 按 钮 ) 便签 ， 如 图 所 示 。 











» ey oy 


| Notes (sqlite3) 
i4 | 上 | [个 | AAS as [+ |@ http://localhost:3000/edit?id= CG | (Qr Google  )| 泌 | 


| Notres (sqlite3) ey 
Notes (Sqlite3) 


View | Add 














Lorem Ilpsum 12 





Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. 
Praesent lihero_ Sed cursus ante danihus diam_ Sed nisi. Nulla quis sem at 
nibh elementum imperdiet. Duis sagittis ipsum. praesent mauris. Fusce nec 
tellus sed augue semper porta. Mauris massa. Vestibulum lacinia arcu eget 
nulla. Class aptent taciti sociosqu ad litora torquent per conubia nostra, 
per inceptos himenaeos. Curabitur sodales ligula in libero. Sed dignissim 
lacinia nunc. 








Submit 














单 击 Submit 按 钮 后 ， 应 用 会 调用 app .post ('/adqd'，,..) 或 者 app.post('/ edit',..)， 
两 者 都 会 更 新 数据 库 然后 将 页 面 重 定向 到 /view。 

7. 处 理 和 调试 错误 

如 果 你 的 代码 有 错误 或 者 有 其 他 问题 发 生 , 应 用 内 部 会 抛 出 错误 对 象 。 在 应 用 中 调试 错误 意 
味 着 要 将 错误 展示 出 来 ， 以 便 了 解 错误 发 生 在 何 时 何 处 。 在 便签 应 用 中 我 们 使 用 util. 1og 语 名 
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实现 错误 的 显示 。 在 notesdqb-salite3 .js 模块 中 , 我 们 使 用 回调 函数 发 送 错误 对 象 到 app . js， 
然后 app .js 抛 出 错误 。 

Express 中 默认 含有 的 一 个 重要 部 分 ， 就 是 在 浏览 器 中 展示 对 开发 者 友好 的 栈 轨迹 。 
日 日 日 http://localhost:3000/view 


[arj[ 公 (AJA 四 j][ I | [ 团 ] [sj [+ |@ http://localhost:3000/view ¢ | (Qr Google ) | 汪 | 


| http:/ /localhost:3000 /view | + 

















TypeError: /Users/davidherron/Node.JS/chap06/newapp/views/viewnotes.html:2 
1| <table> 
>> 2| <% notes.forEach(function(note) { %> 


3| <tr><td> 
4| <p><%= new Date(note.ts) .toString() %>: by <b><%= note.author $%></b></p> 
5| <p><%= note.note %></p> 


Object #<Object> has no method 'forEach' 
at Object.anonymous (eval at <anonymous> 

(/Users/davidherron/Node.JS/chap06/node modules/ejs/lib/ejs.js:195:12)) 
at Object.<anonymous> (/Users/davidherron/Node.JS/chap06/node modules/ejs/lib/ejs.js:197:15) 
at ServerResponse. render (/Users/davidherron/Node.JS/chap06/node modules/express/lib/view.js:375:21) 
at ServerResponse.render (/Users/davidherron/Node.JS/chap06/node modules/express/lib/view.js:234:17) 
at Statement.<anonymous> (/Users/davidherron/Node.JS/chap06/newapp/app.js:33:17) 
at Statement.replacement (/Users/davidherron/Node.JS/chap06/node modules/sqlite3/lib/trace.js:20:31) 
at Statement.replacement (/Users/davidherron/Node.JS/chap06/node modules/sqlite3/lib/trace.js:20:31) 











One error in opening the page. For more information, choose Window > Activity. 有 


Express 提 供 的 app .error 国 数 用 于 捕获 route 函 数 抛 出 的 异常 ， 或 者 在 调用 next (error) 
时 执行 。 
为 了 探索 错误 机 制 ， 我 们 可 以 简单 地 制造 一 个 错误 ， 比 如 在 一 个 nu11 对 象 中 调用 一 个 方法 : 


app.get ('/del', parseUrlParams, functionl(req, res) { 
var notAllowed = null; 
notAllowed.delete(); 








jh 

我 们 刚刚 展示 的 错误 页 面 对 于 开发 者 来 说 有 些 用 处 , 但 是 对 用 户 不 够 友好 , 所 以 我 们 要 对 它 
做 一 些 改进 。 

一 种 改进 方法 是 将 下 面 这 条 命令 插 人 到 app .js 中 : 


app.use (express.errorHandler({ dumpExceptions: true })); 


浏览 器 窗口 会 显示 一 个 简单 的 消息 一 一 Internal Server Error ( 内 部 服务 器 错误 ) 。 这 对 用 户 
来 说 不 会 太 不 友好 ， 但 是 依然 不 合适 。 对 开发 者 友好 的 栈 轨迹 确实 可 以 输出 到 staqerr， 不 会 因 
不 必要 的 细节 内 容 影 响 用 户 ， Ee eh 

建立 一 个 合适 的 对 用 户 友好 的 页 面 ， 其 起 点 是 如 下 的 app .error 函 数 : 


app.error (function(err, req, res) { 
res.render('500.html', { 
title: "Notes ("+nmDbEngine+") ERROR", error: err 
1 
} 


实现 这 这 个 函数 的 方式 有 很 多 ， 比 如 基于 接收 的 错误 对 象 的 类 型 生成 不 同 的 错误 页 面 , 或 者 展 














GD 参见 http:/en.wikipedia.org/wiki/Stack trace。 


6.2 SQLite3 
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示 一 张 小 鸟 从 海中 町 起 一 条 鲸鱼 的 图 片 。 具 体 情况 可 以 你 自己 决定 ,出 于 演示 的 目的 , 我们 使 用 
这 个 错误 页 面 模版 500 .html : 


<b>Internal Server Error</b> 
ERROR: < 和 = error %> 


这 些 都 就 绪 后 ， 我 们 就 将 这 个 错误 展示 到 了 浏览 器 中 。 














Notes (sqlite3) ERROR 








[<|» [|alAl [| [+ |@ htp://localhost:3000/del?id=13 © | (Qr Google Eb 
上 Notes (sqlite3) ERROR | Es 
Notes (sqlite3) ERROR 

View1Add 


Internal Server Error ERROR: TypeError Cannot call method 'delete' of null 














6.2.3 在 Node 中 使 用 其 他 SQL 数据 库 


SQLites 只 是 众多 数据 库 中 的 一 个 。 我 们 选择 它 来 构建 便签 应 用 的 原因 是 ， 它 的 安装 和 配置 
非常 方便 。 在 数据 库 需 要 放置 在 一 台 计算 机 上 时 ， 你 应 该 考虑 使 用 SQLite3。 其 他 SQL 数据 库 有 
另外 一 些 引 人 注目 的 特性 ， 比 如 支持 分 布 式 数据 库 访 问 、 较 高 的 吞吐 量 、 备 份 功能 等 。 

底层 数据 库 ( 接近 SQL ) 如 下 所 示 。 

口 Node-mysql ( https://github.com/fleixge/mode-mysql ) 是 一 个 纯粹 通过 JavaScript 实 现 MySQL 
客户 端 协议 的 数据 库 。 

口 Node-mysql-native ( https://github.com/sidorares/nodejs-mysql-native ) 将 原生 的 MySQL 客 户 
端 库 包装 成 一 个 Node 模 块 。 

口 Node-mysql-libmysqlclient(https://github.com/Sannis/node-mysql-libmysqlclient ) 作 为 MySQL 
的 插件 为 Node 提 供 MySQL 客 户 端 服务 。 

口 Node-postgres ( https://github.com/brianc/node-postgres ) 是 一 个 通过 严格 测试 的 Node 客 户 
端 ， 用 于 连接 Postgres。 它 同时 含有 JavaScript 版 本 和 原生 插件 。 

口 Node-sqlite3 ( https://github.com/developmentseed/mode-sqlite3 ) 是 一 个 为 Node 设 计 的 异步 
非 阻塞 SQLite3 插 件 。 

口 Node-DBI ( https://github.com/DrBenton/Node-DBI) 是 一 个 SQL 数据 库 抽 象 层 。 
高 级 数据 库 ( 含有 ORM 特 性 ) 如 下 所 示 。 

口 FastLegS (https://github.com/didit-tech/FastLegS ) 是 一 种 PostgreSQL ORM， 基 于 node-postgres 

































































构建 。 
口 Node-orm ( https://github.com/dresende/mode-orm ) 是 Node 中 对 象 关系 映射 顺 ， 适 用 于 多 重 
数据 库 。 




















口 persistence.js ( https://github.com/zefhemel/persistencejs ) 是 一 个 异步 JavaScript 对 象 关系 映 
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射 库 ， 可 以 同时 在 浏览 器 和 Node 服 务 器 应 用 中 使 用 。 
口 Sequelize ( https://github.com/sdepold/sequelize ) 是 一 个 用 于 Node 和 MySQL 之 间 的 对 象 关 
系 映射 句 。 


6.3 Mongoose 





MongoDB 是 “nosql” 数 据 库 的 领头 羊 之 一 。(nosql 当 然 也 意味 着 不 用 SQL。 ) 它 被 誉 为 “可 
扩展 、 高 性 能 、 开 源 、 面 向 文档 的 数据 库 ”。 它 使 用 JSON 风 格 的 文档 ,不 用 事先 定义 的 严格 模式 ， 
拥有 大 量 先进 的 特性 。 你 可 以 在 其 网 站 上 看 到 更 多 文档 和 详细 内 容 ， 网 址 为 www.mongodb. org/。 

Mongoose 是 用 于 访问 MongoDB 的 模块 之 一 。 它 是 一 个 对 象 建 模 工具 ， 意 味 着 你 的 程序 负责 
定义 模式 对 象 来 描述 数据 ， 而 Mongoose 负 责 数据 到 MongoDB 的 存储 。Mongoose 对 于 Node 和 
MongoDb 而 言 是 一 个 非常 强大 的 对 象 建 模 工 具 , 使 用 蝇 人 式 文档 , 是 一 个 类 型 灵活 的 系统 , 适用 
于 字段 输入 、 字 段 验证 、 虚 拟 字 段 等 ， 详 见 http:/mongoosejs.comy。 









































cm 站 


6.3.1 安 汉 Mongoose 








如 果 你 已 经 安装 了 npm， 安 装 Mongoose 就 很 容易 了 : 

$ npm install mongoose 

在 使 用 Mongoose 之 前 ， 你 需要 运行 一 个 MongoDB 实 例 。 在 mongodb.com 上 有 预 建 的 二 进 制 
包 ， 你 也 可 以 通过 大 多 数 Linux 系 统 上 的 包 管理 系统 安装 。 在 Mac OS X 上 你 也 可 以 通过 MacPorts 
安装 。 你 可 以 访问 它们 的 网 站 获取 更 多 信息 ， 特 别 是 针对 具体 操作 系统 的 快速 入 门 向 导 ( www. 
mongodb.org/display/DOCS/Quickstart )。 

我 们 需要 两 个 步骤 来 验证 是 否 已 经 可 以 使 用 MongoDB。 第 一 步 是 在 本 地 数据 目录 启动 
MongoDB 服 务 器 (mongoq )， 如 下 面 的 截图 所 示 。 



































Terminal 一 mongod — 90x11 
$ 旦 
$ rm -rf data 
$ mkdir data 
$ mongod --dbpath ./data 
Thu Jul 7 15:19:22 MongoDB starting : pid=18682 port=27817 dbpath=./data 64-bit 
Thu Jul 7 15:;19:22 db version v1.6.6-pre-, pdfile version 4.5 
Thu Jul 7 15:19:22 git version: nogitversion 
Thu Jul 7 15:19:22 sys info: Darwin tippy.local 10.7.0 Darwin Kernel Version 10.7.0: Sat | 
Jon 29 15:17:16 PST 2811; root:xnu-1584.9.37~1/RELEASE_1386 i386 6005T_LIB_VERSION=1_45 
Thu Jul 7 15;19:22 [initondlisten] waiting for connections on port 27817 
Thu Jul ?7 15:19:22 [websvr] web adnin interface listening on port 28017 


在 开发 的 时 候 这 个 方法 非常 实用 , 并 且 不 需要 耗费 太 多 时 间 。 你 可 以 在 任何 时 候 用 Controlt+C 
结束 进程 ， 并 用 这 里 的 命令 在 一 个 干净 的 目录 下 重新 开始 。 

下 一 步 是 在 快速 入 门 向 导 ( 在 前 面 的 链接 中 可 以 查看 ) 中 通过 用 户 交 互 检查 是 否 可 使 用 
MongoDB。 
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. Terminal 一 mongo 一 72x8 
$ mongo 旦 
MongoDB shell version: 1.6.6-pre- 
connecting to: test 
> db.foo.sove( {a :1}) | 
> db.foo.find() 
{ "id" : ObjectId("4e16313464q1126e2q769838"), "a" : 1} 


> 











例子 里 的 操作 会 插入 一 个 文档 ( JSON 格 式 的 fa: 1} ) 到 名 为 foo 的 集合 中 。 命 令 
db.foo.find 用 于 查询 集合 foo 并 以 JSON 格 式 列 出 集合 中 的 所 有 元 素 ( 因为 没有 查询 参数 )。 
MongoDB 网 站 上 有 完整 的 使 用 文档 ， 包 括 Mongo shell 的 使 用 方法 。 





6.3.2 ”用 Mongoose 实现 便签 应 用 


为 了 学 习 Mongoose 的 使 用 方法 ， 我 们 将 实现 便签 应 用 的 另外 一 个 版 本 。 
构架 基本 和 SQL 版 本 类 似 ， 不 过 编写 的 时 候 使 用 的 是 Mongoose 对 象 标识 符 。 


Var NoteSchema = new Schema (1{ 


七 S : { type: Date, default: Date.now }, 
auUthor GtrTLNng.:; 
note : String 


二 

mongoose.model('Note', NoteSchema); 

此 处 使 用 字段 的 目的 也 和 使 用 SQL 时 一 致 。 因 为 Mongoose 使 用 JavaScript 实 现 ， 所 以 我 们 使 
用 的 数据 类 型 也 是 JavaScript 对 象 。 以 防 在 创建 对 象 的 时 候 没 有 提供 ts 值 ， 此 处 为 其 使 用 默认 值 。 

现在 开始 编码 了 。 

1. 数据 库 抽象 模块 一 notesdb-mongoose .js 

和 sqlite3 便 签 应 用 一 样 , 这 个 模块 被 作为 数据 库 接口 库 被 应 用 的 其 他 部 分 使 用 。 它 实现 了 
3 种 数据 库 CRUD 功 能 , 具体 表现 为 adda( 创建 )_finaNoteById( 读 取 )、eait( 更 新 ) 和 daelete 
(删除 ) 这 3 个 标签 文档 操作 函数 。 

与 基于 salite3 的 便签 应 用 一 样 ，notesdqb-mongoose .js 实现 了 MVC 架 构 中 的 模型 部 分 : 

var util = require('util'); 

Var mongoose = require('mongoose'); 

Var Schema = mongoose.Schema; 

Var dburl = 'mongodb://localhost/chap06'; 

exports.connect = function(callback) { 

mongoose.connect (dburl);} 
} 
exports.disconnect = function(callback) { 


mongoose.disconnect (callback); 


} 
这 段 管理 代码 引入 了 一 个 模块 并 添加 了 .connect 和 .disconnect 国 数 。 变 量 qabur1 用 于 连 
接 已 运行 的 MongoDB。 这 些 合 在 一 起 负责 处 理 与 MongoDB 的 连接 ， 而 程序 本 身 只 需要 在 启动 的 
时 候 调 用 .connect， 并 停止 前 调用 .disconnect。 GE 
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exports.setup = function(callback) { callback (null); } 
Var NoteSchema = new Schema ({ 

ts : { type: Date, default: Date.now }, 

author : String, 

note on le 


} 
mongoose.model ('Note', NoteSchema); 
Var Note = mongoose.model ('Note'); 











exports.emptyNote = { "_id": "", author: "", note: "" }; 
这 部 分 代码 负责 定义 模式 ， 2 十 我 们 已 经 在 前 面 讨 论 过 了 。 这 一 模式 的 创建 方法 是 var 
NoteSchema = new Schema(...)。 我 们 用 如 下 代码 将 其 t 作 为 Mongoose 的 模型 注册 进去 ， 


mongoose.mode1l('Note'，NoteSchema) : 
Var Note = mongoose.model ('Note'); 


在 注册 完 模式 和 模型 后 ， 你 的 程序 就 可 以 在 数据 库 中 创建 文档 了 : 


exports.add = function(author, note, callback) { 
Var newNote = new Note(); 
newNote.author = author; 
newNote.note = note; 
newNote.save(function(err) { 
if (err) { 
util.log('FATAL '+ err);} 
callback (err); 
} else 
allbacRk (null)s 








用 
} 


我 们 通过 创建 对 象 的 一 个 新 实例 , 将 数据 赋 给 相应 字段 , 并 调用 . save 方法。 在 这 个 例子 里 ， 
我 们 没有 给 ts 字段 赋值 ， 不 过 模式 定义 会 声明 一 个 默认 值 : 


exports.delete = function(id, callback) { 
exports.findNoteById(id, function(err, doc) { 
站 (EY) 
callback (err); 
else { 
tl.L0g (til, ndect.(dos))s 
doc.remove(); 
过 臣下 下 起 可 区 长 (站 这 下 了 水 








jy 
} 


从 数据 库 删 除 一 条 便签 需要 两 个 步骤。 我 们 需要 先 使 用 findqNoteById 方 法 检索 便签 ， 然 后 
调用 对 象 的 . en 我 们 会 在 稍 后 进行 展示 。 


exports.edit = function(id, author, note, callback) { 
exports.findNoteById(id, function(err, doc) { 
二 在 ， 必 志 禄 到 》 
callback (err); 
else { 
doc.ts = new Date(); 
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doc.author = author; 
doc.note = note; 
doc.save(function(err) { 
if (err) { 
util.log('FATAL '+ err); 
callback (err); 
} else 
callback (null); 
之 
上 


} 
同样 ,更 新 一 条 便签 也 需要 两 个 步骤 。 首 先 我 们 要 检索 便签 然后 给 其 字段 赋 上 新 的 值 ， 表 
调用 .save 方 法 进行 保存 : 
exports.allNotes = function(callback) { 
Note.find({}, callback); 
} 
exports.forAll = function(doEach, done) { 
Note.find({}, function(err, docs) { 
if (err) { 
util.log('FATAL '+ err); 
done (err, null); 
} 
docs.forEach(function(doc) { 
doEach (null, doc); 
下 
done (null); 
上 




















} 
Var findNoteById = exports.findNoteById = function(igd, 
callback) { 
Note.findone({ _id: id }, function(err, doc) { 
if (err) { 
util.log('FATAL '+ err); 
callback (err, null); 
} 
callback (null, doc); 
上 
3 


现在 我 们 看 看 负责 在 数据 库 中 检索 便签 的 这 3 个 函数 。 
在 allNotes 和 foraAl1 函 数 中 ,我 们 使 用 了 Notes . find 方法 。 它 和 后 台 使 用 的 Querry 对 象 
一 样 都 是 Mongoose 中 强大 的 一 部 分 。 它 的 作用 与 SQL SELECT 语句 中 的 WHERE 类 似 ， 但 是 它 更 加 
简洁 易 读 。 因 为 这 两 个 函数 中 的 Querry 对 象 都 是 空 的 , 所 以 Mongoose 会 把 便签 集合 中 所 有 的 文档 
都 检索 出 来 。 
在 .findqNoteById 函 数 中 , 我 们 调用 了 Note. findqone 方 法 通过 ia 字段 来 找到 一 个 特定 的 
便签 。 我 们 的 方法 是 传人 一 个 Query 对 象 L_ia: idqj} 来 用 _id 字 段 匹配 ida。_idq 字 段 是 MongoDB 
ee 的 ID ， 用 于 标识 存储 的 文档 。 因 为 它 的 作用 和 基于 sqlite3 的 便签 应 用 中 的 ts 
字段 一 样 ， 所 以 我 们 使 用 _iq 字 段 值 来 标识 便签 。Mongoose 的 Query 对 象 还 有 更 多 用 处 ， 具 体 可 











加 
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见 mongoosejs.org。 

2. 初始 化 数据 库 一 一 setup .js 

和 使 用 MongoDB 时 一 样 ， 此 处 亦 有 两 种 方式 来 初始 化 数据 库 。 你 可 以 使 用 mongo shell 命 令 ， 
如 下 面 的 截图 所 示 。 











. Terminal — mongo — 76x12 
$ 田 
$ mongo 
MongoD8 shell version: 1.6.6-pre- 
connecting to: test 
> Use chap86 ; 
switched to db chap66 
> db .notes.save({ ts: "Tue May 18 2611 28:26:38 GMT-8788 (PDT)", author: "so 
meone", note: "A meaningful note” }); 
> db.notes.find(); 
{ "id"” : 0bjectId("4e16484f64f ?b4392f563b7a" )，"ts”:“Tue May 18 2611 26:2 
6:38 6GHT-6766 (PDT)", "author” : "someone"”, "note" : "A meaningful note” } 
> 


男 一 种 方式 是 使 用 之 前 的 setup . js 脚本 。 它 里 面 的 一 对 代码 行 可 以 实现 notesdb-sqlites3 
和 notesdb-mongoose 之 间 的 切换 。 


// var notesdb = require('./notesdb-sqlite3'); 
Var notesdb = require('./notesdb-mongoose'); 


通过 注释 掉 不 同 的 语句 完成 切换 后 ， 再 按照 下 面 的 方式 运行 脚本 : 
$ node setup 
脚本 本 身 不 会 输出 任何 内 容 , 但 是 你 可 以 使 用 show.js 显 示 并 查看 数据 库 。 
3. 在 控制 台中 显示 便签 一 一 show.js 
我 们 可 使 用 之 前 的 show .js 显示 数据 库 中 的 每 一 个 条 目 。 我 们 只 需 和 在 前 面 的 setup .js 中 
一 样 做 修改 ， 按 照 如 下 的 方式 运行 脚本 : 
$ node show 
7 Jul 17:20:58 - ROW: { doc: 
{ ts: Fri, 08 Jul 2011 00:13:22 GMT, 


_id: 4e164ba289dc189149000001， 
note: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. 



































Integer nec odio. Praesent .. Sed dignissim lacinia nunc.', 
author: 'Lorem Ipsum 12' }, 
activePaths: 
{ paths: 
{ note: 'init', 


author: 'init', 
_id: 'init', 
tears: 了 }; 
states: { init: [Object], modify: {}, require: {} }, 
stateNames: [ 'require', 'modify', 'init' ] }, 
saveError: null, 
isNew: false, 
pres: { save: { serial: [Object], parallel: [] } }, 
errors: undefined } 
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4. 整合 应 用 一 一 app.js 

由 于 notesdb-mongoose.js 的 API 和 notesdb-sqlite.js 的 一 样 ,我 们 可 以 通过 极 小 的 修 
改 重用 setup .js 和 show.js。 这 对 于 app .js 来 说 也 一 样 。 修改 本 身 稍 有 不 同 , 但 意图 是 相同 的 。 
然而 ， 因 为 有 区 别 存在 ， 所 以 我 们 必须 使 用 不 同 的 模板 文件 。 

app.js 中 的 修改 如 下 : 


// var nmDbEngine = 'sqlite3'; 
Var nmDbEngine = 'mongoose'; 


现在 ， 我 们 需要 创建 目录 views-mongoose， 然 后 准备 创建 下 述 模板 文件 。 

(1) 首先 是 layout .html， 它 和 之 前 完全 一 样 ， 所 以 只 需要 复制 一 份 就 行 : 

$ cp views-sqlite3/layout.html views-mongoose/layout.html 

(2) 下 一 个 是 viewnotes .html, 它 和 之 前 的 一 样 ， 不 过 需要 按照 下 面 的 方式 修改 hidden 类 
型 的 id input 标 签 : 











<input type='hidden' name='id' value='<%= note._iqd %>'> 
(3) 基本 和 上 面 类 似 , 复制 aGdedit .html 文 件 ， 然 后 按照 下 面 的 方式 修改 hidaen 类 型 的 ia 
input 标 签 : 
<input type='hidden' name='id' value='<%= note._id %>'> 
这 里 的 模板 和 SQLite3 版 的 区 别 是 hidaaen 类 型 的 表单 字段 ;ia 不 同 。 就 像 我 们 之 前 提 到 的 那 
样 ，Mongo 提 供 了 一 个 全 局 唯一 的 _ia 值 来 标识 每 一 个 已 存储 的 文档 。 
现在 我 们 已 经 将 应 用 整合 完毕 ， 可 以 运行 Mongoose 便 签 应 用 了 : 
$ node app 
然后 你 可 以 在 浏览 器 中 访问 http:/localhost:3000/ 浏 览 应 用 。 它 看 起 来 和 之 前 基于 SQLites 的 版 
本 类 似 ， 只 是 标题 会 不 同 ， 如 截图 所 示 。 


和 0, 











Nores (mongoose) 
[<|r| | 含 I IAIA eI | ws [+ |@ http://localhost:3000/view © | [(Qr Google ) | 郑 | 


由 Notes (mongoose) | 时 


Notes (mongoose) 

















View | Add 


Thu Jul 07 2011 17:13:22 GMT-0700 (PDT): by Lorem Ipsum 12 
Delete 
Lorem ipsum dolor sit amet. consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante 
dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet. Duis sagittis ipsum. Praesent mauris. 
Fusce nec tellus sed augue semper porta. Mauris massa. Vestibulum lacinia arcu eget nulla. Class aptent 
taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Curabitur sodales ligula in 
libero. Sed dignissim lacinia nunc. 
Thu Jul 07 2011 17:13:22 GMT-0700 (PDT): by Lorem Ipsum 23 





Curabitur tortor. Pellentesque nibh. Aenean quam. In scelerisque sem at dolor. Maecenas mattis. Sed 

convallis tristique sem. Proin ut ligula vel nunc egestas porttitor. Morbi lectus risus, iaculis vel, suscipit quis. 

luctus non. massa. Fusce ac turpis quis ligula lacinia aliquet. Mauris ipsum. Nulla metus metus. ullamcorper 
vel, tincidunt sed, euismod in, nibh. Quisque volutpat condimentum velit. Class aptent taciti sociosqu ad 

litora torquent per conubia nostra, per inceptos himenaeos. 


Thu Jul 07 2011 17:13:22 GMT-0700 (PDT): by Lorem Ipsum 34 
Nam nec ante. Sed lacinia, uma non tincidunt mattis, tortor neque adipiscing diam, a cursus ipsum ante quis 


turpis. Nulla facilisi. Ut fringilla. Suspendisse potenti. Nunc feugiat mi a tellus consequat imperdiet. 1 
Vestibulum sapien. Proin quam. Etiam ultrices. Suspendisse in justo eu magna luctus suscipit. Sed lectus. 
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这 个 版 本 的 便签 应 用 和 之 前 的 运行 起 来 完全 一 样 , 两 个 版 本 的 便签 应 用 分 别 是 用 于 演示 如 何 
用 SQL 和 Mongo 数 据 库 构建 应 用 。 


6.3.3 对 MongoDB 数据 库 的 其 他 支持 


Mongoose 不 是 唯一 一 个 在 Node 中 使 用 MongoDB 的 工具 。 

你 可 能 会 感到 惊讶 的 是 MongoDB shell 和 Node MongoDB 模 块 API 的 区 别 。 由 于 MongoDB shell 
使 用 了 JavaScript 命 令 解 释 器 , 你 会 认为 它们 的 API 是 一 模 一 样 的 。 尽 管 许多 模块 声称 和 MongoDB 
shell 类 似 ， 它 们 都 没有 使 用 一 样 的 API。 

口 Node-mongodb ( https://github.com/orlandov/node-mongodb ) 是 一 个 面向 MongoDB 的 实验 

性 质 的 异步 Node 接 口 。 

口 node-mongodb-native ( https://github.com/christkv/node-mongodb-native ) 是 另外 一 个 驱动 

程序 。 

口 node-mongolian ( https://github.com/marcello3d/node-mongolian ) 是 一 个 “了 不 起 ”的 驱动 

程序 ， 它 试图 做 到 和 MongoDB shell 非 常 类 似 。 

口 Mongolia ( https://github.com/masylum/mongolia ) 是 MongoDB 上 一 个 灵活 的 “ 非 魔法 ” 层 ， 

不 过 不 是 ORM。 

口 Mongoose ( http://www.learnboost.com/mongoose/ ) 是 我 们 刚刚 使 用 过 ， 基 于 MongoDB 的 

一 个 ORM 系 统 。 

口 Mongous ( https://github.com/amark/mongous ) 是 一 个 非常 简单 的 面向 MongoDB 的 接口 ， 

语法 和 jQuery 类 似 。 

口 node-nosql-thin ( https://github.com/dmcquay/node-nosql-thin ) 是 一 个 面向 MongoDB 的 非常 
“瘦小 ”的 接口 库 ， 未 来 可 能 支持 其 他 “NoSQL 数 据 库 ”。 


6.4 如何 实现 用 户 验 证 


很 多 应 用 都 需要 用 户 登 录 ， 然 后 用 户 才能 进行 一 些 特权 操作 。 由 于 HTTP 是 一 个 无 状态 的 协 
议 ， 验 证 用 户 的 唯一 方式 就 是 发 送 一 个 cookie 到 浏览 器 上 ， 然 后 验证 标识 符 。cookie 包 含 了 应 用 
中 用 于 验证 用 户 的 数据 。 我 们 将 快速 了 解 登录 表单 的 实现 、cookie 的 发 送 和 无 cookie 时 对 访问 便 
签 应 用 的 阻止 。 

我 们 要 对 app . js 做 两 个 修改 ， 首 先 在 服务 器 对 象 配置 中 添加 cookieParser 中 间 件 : 


Var app = express.createServer(); 
app.use (express.logger ()) 
app.use (express.cookieParser()); 
app.use (express.bodyParser()); 


下 一 步 是 添加 一 个 简单 的 路 由 中 间 件 函数 来 检查 用 户 是 否 被 允许 访问 。 在 这 个 例子 里 , 我 们 
只 检查 cookie 是 否 等 于 AoOK， 因 为 这 个 单词 通常 意味 着 一 切 都 没 问 题 。 


var checkAccess = function(req, res, next) { 
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if (!req.cookies 
|| !req.cookies.notesaccess 


11 req.cookies.notesaccess !== "AOK") { 
res.redirect('/login'); 
} else { 
next (); 


} 
} 


cookieParser 中 间 件 在 这 里 做 了 很 多 工作 ,查找 cookie, 解析 cookie, 然后 将 解析 出 来 的 值 
放 到 req 对 和 象 中 。 当 存在 cookie 时 ， 它 的 值 会 被 放 入 req .cookies 中 ， 然 后 我 们 就 可 以 如 此 处 所 
示 获 取 cookie 的 值 。 如果 没 有 cookie 或 者 req 对 象 中 不 存在 notesaccess 字 段 ， 又 或 者 cookie 的 值 
不 是 AOK， 浏 览 器 就 会 重 定向 到 URIL 为 /login 的 页 面 。 

在 了 解 URL 为 /login 的 处 理 程序 之 前 ， 我 们 先 添加 cookieParser 中 间 件 到 便签 应 用 路 由 
上 。 这 非常 容易 : 


app.get ('/view', checkAccess, function(req, res) { 











:3 
我 们 特别 在 每 一 个 路 由 器 函数 的 定义 中 调用 了 checkaccess 困 数 。 这 可 以 保证 check- 
Access 子 数 会 在 每 一 个 便签 的 URL 处 理 中 被 调用 ， 也 就 保证 每 个 便签 URL 都 能 受到 登录 保护 。 
不 需要 受到 登录 保护 的 URL 处 理 也 就 不 需要 使 用 checkaAccess 路 由 中 间 件 函数 。 
这 两 个 路 由 需 函 数 对 应 处 理 URL 为 /1ogin 的 页 面 : 
app.get ('/login', function(req, res) { 
res.render('login.html', { 
title: "Notes LOGIN ("+nmDbEngine+")", 
3 
让 
app.post('/login', function(req, res) { 
// 检查 表单 中 输入 的 凭证 
res.cookie('notesaccess', 'AOK'); 


res.redirect('/view'); 


3 
最 后 使 用 下 面 的 模板 


<form method='POST' action='/login'> 
<p>Click the <i>Login</i> to log in.</p> 
<input type='submit' value='Login' /> 
</form> 


如 果 你 要 实现 一 个 真正 安全 的 系统 ， 这 里 还 需要 做 一 些 事情 。 

当 checkaccess 函 数 将 用 户 的 浏览 器 重 定向 到 /1ogin 页 面 时 ， 第 一 个 路 由 器 函数 会 在 浏览 
器 中 泻 染 1ogin .phtml 模板 ， 和 截图 如 下 。 

一 个 真正 安全 的 系统 至 少 需要 有 输入 用 户 名 和 密码 的 输入 框 。 不 过 我 们 跳 过 了 这 部 分 , 只 是 


让 用 户 单 击 Login 按 钮 。 6 











login.html: 
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A A 


Notes LOGIN (mongoose) 








[<|» |[ 人 | [+ |@ http://localhost:3000/login & | (Qr- Google 六 
中 Nores LOGIN (mongoose) i 攻 
Notes LOGIN (mongoose) 

View | Add 


Click the Login to log in. 


一 一 
iogin ) 





按钮 本 身 是 表单 的 一 部 分 ， 它 会 引发 app .post ('/1login'..) 路 由 函数 的 执行 。 如 果 这 是 
一 个 真正 安全 的 系统 , 这 个 函数 会 检查 登录 表单 提交 上 来 的 用 户 验证 信息 ,如果 数据 和 用 户 数据 
库 中 的 数据 匹配 则 放出 一 个 用 于 身份 验证 的 cookie。 而 这 里 的 路 由 函数 值 放出 了 值 为 AOK 的 
cookie， 然 后 将 浏览 需 重 定向 到 /view 页 面 。 

虽然 该 系统 不 是 一 个 完全 安全 的 系统 , 但 是 它 依然 包含 了 一 个 安全 系统 的 主干 部 分 。 许 多 网 
站 都 含有 用 户 登录 表单 ， 对 于 每 一 次 页 面 请求 使 用 并 验证 cookie。 我 们 实现 的 功能 包括 检查 验证 
cookie 并 纠正 cookie 值 、 一 个 到 登录 表单 的 重 定 癌 、 一 个 登录 表单 检查 ， 以 及 癌 浏 览 絮 发 送 用 于 
身份 验证 的 cookie。 


6.5 小结 


我 们 在 这 一 章 学 习 了 Node 中 的 许多 数据 存 取 知识 。 数据 存 取 对 于 各 类 应 用 都 很 关键 , 下 面 回 
顾 一 下 所 学 的 内 容 。 

口 Node 不 包括 内 置 的 数据 存储 引擎 支持 ， 但 是 Node 社 区 已 经 开发 了 很 多 模块 来 完成 与 很 多 
现存 数据 库 的 交互 。 

口 安装 数据 存储 引擎 模块 就 是 安装 服务 器 和 客户 端 库 等 依赖 。 

口 SQLite3 提 供 了 一 个 不 需要 安装 和 配置 的 、 开 发 SQL 应 用 的 方式 。 

口 分 别 基于 SQL 和 MongoDB 数 据 库 实现 相同 的 应 用 。 

口 虽然 ORM 技 术 最 好 以 SQL 数据 存储 为 基础 ， 但 是 Node 社 区 已 经 开发 了 适合 MongoDB 和 
CouchDB 的 ORM。 

口 如 何 〈 部 分 ) 实现 MVC 构 架 。 

口 在 Express 应 用 中 处 理 表单 提交 。 

口 基于 文档 的 数据 库 系统 ( 如 MongoDB ) 比 SQL 更 接近 于 现代 编程 语言 和 应 用 。 

我 们 已 经 在 本 书 中 学 习 了 很 多 知识 。 我 们 首先 大 致 了 解 了 Node 和 可 以 用 Node 实 现 的 软件 ， 
然后 学 习 了 如 何 分 别 在 开发 环境 和 部 署 环境 下 安装 Node 和 npm, 并 利用 这 些 基 础 知识 开发 了 Node 
模块 和 一 些 应 用 ， 从 而 学 习 了 如 何 构 建 Web 应 用 、HTTP 客 户 端 与 服务 顺应 用 、Node 事 件 循 环 机 
制 , 以 及 如 何 将 长 时 间 执 行 的 CPU 密集 型 算法 转换 成 依赖 Node 事 件 循环 机 制 的 多 个 计算 任务 、 如 
何 使 用 网 络 服务 分 配 工作 给 后 台 进 程 ， 以 及 如 何 将 数据 从 数据 库 转 移 到 Node 应 用 中 。 
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Node Web 开 发 


作为 服务 器 端的 JavaScript 解 释 器 ，Node 是 一 个 轻 量 高 效 的 开 
发 平台 ， 用 于 构建 响应 快速 、 高 度 可 扩展 的 Web 应 用 。 它 使 用 事件 
驱动 和 非 阻塞 的 MO 模型 ， 非 常 适合 开发 数据 密集 、 对 实时 响应 要 
求 高 的 分 布 式 应 用 ， 在 微软 、eBay、Linkedln、 雅 虎 等 世界 知名 公 
司 均 有 成 功 的 应 用 。 

本 书 是 Node 开 发 基础 教程 ， 通 过 大 量 示例 介绍 如 何 使 用 HTTP 
服务 器 和 客户 端 对 象 、Connect 和 Express 应 用 框架 、 异 步 执行 算 
法 ， 以 及 如 何 结合 使 用 SQL 和 MongoDB 数 据 库 。 另 外 ， 本 书 同 时 


和 


NE 玫 关 打造 高 性 能 WE 用 


务 器 和 客户 端 应 用 的 开发 ， 阐 述 了 很 多 Node 使 用 方式 ， 包 括 在 应 


[四 稚 上 席 架 构 师 精准 解读 最 炙手可热 的 


框架 的 情况 下 开发 网 站 的 方法 。 本 书 还 介绍 了 Node 的 CommonJS Web 开 发 技术 
模块 系统 ， 帮 助 开 发 人 员 实 现 一 些 重要 的 面向 对 象 设计 方案 。 


本 书 适合 具有 一 定 JavaScript 和 Web 应 用 开发 基础 知识 、 打 算 从 基础 到 实践 


使 用 服务 器 端 JavaScript 开 发 高 性 能 Web 应 用 的 开发 人 员 阅 读 。 
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